Что проверить, если настройка Firefly III в Home Assistant завершается timeout при большом списке счетов: безопасная матрица страниц API, временная шкала и минимальный пакет фактов без удаления финансовых данных.
Сначала определите точную границу сбоя
Не начинайте с удаления счетов, повторного создания пользователя или перевыпуска токена. Официальная документация Home Assistant описывает Firefly III как интеграцию через API и указывает, что для настройки нужен access token. Поэтому сначала разделите четыре наблюдения: принимает ли Firefly III авторизацию, отвечает ли endpoint bills, содержит ли ответ признаки нескольких страниц и переходит ли клиент Home Assistant после первой страницы дальше. Успешный HTTP-ответ подтверждает доступ к конкретному запросу, но не доказывает, что весь список обработан. Ошибка авторизации, медленный сервер и повтор одной страницы требуют разных веток и не должны смешиваться одним общим выводом «интеграция не работает».
Постройте read-only матрицу двух страниц
OpenAPI-спецификация Firefly III документирует endpoint `/v1/bills`, параметры `limit` и `page`, а также стандартный размер пагинации 50 элементов. В собственном защищённом интерфейсе API или просмотрщике запросов проверьте только метаданные ответа для первой и, если она существует, второй страницы: код ответа, номер текущей страницы, общее число страниц, количество элементов и длительность. Не сохраняйте названия счетов, суммы, даты платежей и заголовок Authorization. Если обе страницы отвечают штатно, а настройка всё равно зацикливается на первой, граница смещается к клиентскому обходу страниц. Если вторая страница не отвечает напрямую, статья больше не соответствует симптому — сначала разбирайте сервер и доступность данных.
Сопоставьте один запуск с журналом запросов
Запустите настройку один раз и отметьте время начала, первый запрос bills, последующие номера `page` и момент отмены. Не повторяйте Submit много раз: параллельные попытки создадут лишние запросы и разрушат последовательность. Для проверки достаточно ответить на вопрос, меняется ли номер страницы. Последовательность `page=1`, затем `page=2` означает, что переход выполняется и причину следует искать дальше; серия одинаковых запросов первой страницы до timeout фиксирует другую границу, но сама по себе не доказывает конкретную ошибку библиотеки. Сравнивайте номера страниц и статусы, а не размер или содержимое финансового JSON. Открытый issue подтверждает наличие такого обсуждения только для одной конфигурации.
Не превращайте уменьшение списка в опасный обход
Количество счетов может выглядеть удобной контрольной переменной, однако реальные финансовые записи нельзя удалять ради диагностики. Если нужен независимый опыт, используйте только отдельный тестовый экземпляр Firefly III с искусственными записями без персональных данных и с теми же версиями; production-экземпляр оставьте неизменным. Результат «одна страница на тестовом экземпляре подключается, две — нет» усиливает воспроизводимость границы, но не доказывает её для всех версий. Не увеличивайте API limit как постоянное исправление без рекомендации проекта: это может изменить размер ответа и нагрузку, скрыв дефект. Критерий остановки — повтор первой страницы в одном чистом запуске при исправных read-only ответах обеих страниц.
Соберите минимальный пакет для эскалации
Передайте версии Home Assistant Core и Firefly III, тип установки, число страниц без перечня счетов, значения `current_page` и `total_pages`, длительность двух read-only ответов и очищенную последовательность номеров page за один setup. Укажите, возвращались ли 200, 401, 404 или timeout, но удалите домен частного сервера, IP, access token, cookie, имена счетов, суммы и полный response body. Не прикладывайте `.env`, дамп базы или необработанный diagnostics archive. Исправление следует считать подтверждённым только после официального релиза и повторного прохождения той же матрицы: обе страницы доступны, настройка завершается и журнал больше не повторяет первую страницу до отмены.
Материал подготовлен редакцией VOne с применением ИИ для построения диагностического дерева; технические утверждения сверены по официальным источникам, а публичное обращение использовано только как обезличенный сигнал боли.
Источники и проверка
- Home Assistant: Firefly III integration проверено 2026-08-14
- Firefly III OpenAPI specification v6.6.6 проверено 2026-08-14
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.