Настоящая сложность выключения света по таймеру в Home Assistant: почему после перезапуска действие может выполниться дважды?
Эксперимент с SQLite и моделью лампы показывает восстановление задач, повторные действия, свежесть наблюдений и запоздавшие подтверждения.
Обновлено
В предыдущей статье мы обсудили, как перезапуск Home Assistant прерывает отсчёт for и выполняющуюся задержку. Самое естественное предложение — сохранить время, к которому нужно выключить свет, а после запуска проверить просроченные задачи.
Но сохранённое время решает лишь вопрос «когда нужно действовать». Есть вопрос сложнее: действие уже выполнено, но система не успела записать, что оно завершено. Что делать после перезапуска?
При повторной попытке действие может выполниться дважды. Если не повторять, можно пропустить задачу, которая на самом деле ещё не выполнялась. Запись времени во вспомогательный элемент сама по себе не устраняет это противоречие.
В этой статье с помощью SQLite и имитатора светильника проводится эксперимент с искусственно вызванным сбоем и рассматриваются компромиссы для обычного домашнего освещения. Скрипт действительно запускался, но это не интеграционный тест Home Assistant; устройствами в вашем доме он не управлял. Приведённый автомат состояний — ориентир для проектирования, а не готовый YAML, который можно просто вставить в конфигурацию.
Сначала различим два внешне похожих правила
«Выключить свет через десять минут» может означать две разные вещи:
| Правило | Какой факт важен | Что остаётся неизвестным из-за остановки системы |
|---|---|---|
| Выключить свет, когда в комнате никого не было непрерывно десять минут | Отсутствие людей в течение всего периода | Система может не знать, заходил ли кто-то во время остановки |
| Пользователь запускает десятиминутный обратный отсчёт, по истечении которого нужно попытаться выключить свет | Время выполнения и условия на момент попытки | Нужный момент мог пройти во время остановки, а результат действия мог не сохраниться |
Эти правила не взаимозаменяемы.
Для первого правила восстановление старой временной метки не доказывает, что во время остановки комната оставалась пустой. Если нет независимой и надёжной истории показаний датчика, консервативный подход — заново понаблюдать за состоянием в течение некоторого времени.
Эксперимент в этой статье относится ко второму правилу: пользователь явно создаёт задачу на выключение света по таймеру; по истечении срока система пытается выключить обычный тестовый светильник, только если получила достаточно новое наблюдение об отсутствии людей. Эксперимент не претендует на восстановление непрерывной истории присутствия во время остановки.
Почему одного вспомогательного элемента со временем недостаточно
input_datetime в Home Assistant позволяет хранить дату и время. Согласно официальной документации, при заданном допустимом значении initial элемент начинает с него; иначе восстанавливает состояние, которое было до остановки.[1]
Это подходит для хранения времени выполнения, но запись «вчера в десять вечера» не говорит, действительна ли задача. Она могла уже завершиться, быть отменена пользователем или относиться к предыдущему запуску таймера.
Поэтому нужно как минимум представить три вещи: идентификатор задачи, время выполнения и состояние задачи. Например:
id=42
due=некоторый точно заданный момент времени
state=pending
id отличает новую задачу от старой; due определяет, когда можно попытаться выполнить действие; state различает ожидание выполнения, завершение и отмену.
В Home Assistant похожие данные можно представить несколькими вспомогательными элементами. Но нельзя считать, что обновления нескольких элементов автоматически образуют одну транзакцию базы данных. Если строго необходимо, чтобы они либо все сохранились, либо все не сохранились, нужен компонент с соответствующими возможностями хранения и транзакций, а также проверка его поведения при восстановлении. Здесь SQLite используется, чтобы исследовать проблему отдельно от настройки интерфейса. Это не рекомендация напрямую изменять собственную базу данных Home Assistant.
Окно прерывания, которое нельзя игнорировать
Предположим, время выполнения наступило, и процесс выглядит так:
Прочитать задачу в состоянии pending
Проверить текущие условия
Отправить команду выключения света
Записать для задачи состояние done
Если программа прервётся после третьего шага, но до четвёртого, свет, возможно, уже выключен, а на диске задача всё ещё имеет состояние pending. После перезапуска запись может выглядеть точно так же, как в случае, когда программа прервалась ещё до отправки команды.
Обратный порядок тоже не решает проблему: если сначала записать done, а потом выключить свет, прерывание между этими шагами оставит задачу завершённой по записи, хотя свет всё ещё горит.
| Порядок учёта | Окно прерывания | Риск при восстановлении |
|---|---|---|
| Сначала отметить завершение, затем выполнить действие | После записи о завершении, до действия | Пропуск выполнения |
| Сначала выполнить действие, затем отметить завершение | После действия, до записи о завершении | Повторное выполнение |
Локальная транзакция SQLite защищает только локальные записи. Она не может включить физическое действие удалённого светильника в ту же транзакцию. Для более строгих гарантий исполнитель должен поддерживать, например, устранение дубликатов запросов или возможность узнать результат операции, а протокол обеих сторон должен это учитывать. Одного флага в автоматизации недостаточно.
Эксперимент: две одинаковые попытки дают противоположные результаты для off и toggle
Мы подготовили имитатор светильника, который вначале включён, создали задачу со временем выполнения 600 и попытались выполнить её в модельный момент 700.
Сбой вызывается после того, как светильник получил команду, но до записи о завершении задачи. Затем скрипт закрывает соединение с базой данных и открывает его снова, имитируя состояние хранилища, которое увидит программа при следующем запуске. Значения времени — заданные вручную целые числа, а не измеренные секунды. Настоящего отключения питания операционной системы здесь тоже нет.
После восстановления задача всё ещё ожидает выполнения, поэтому делается новая попытка.
Результат этого запуска:
crash_after_action_off calls=2 lamp_on=false
crash_after_action_toggle calls=2 lamp_on=true
После двух последовательных команд выключения имитатор светильника остаётся выключенным. После двух команд переключения он снова включён.
Поэтому для задач, допускающих повторную попытку после восстановления, предпочтительны операции с явно заданным конечным состоянием, например «выключить», а не «переключить текущее состояние». В этом небольшом сценарии именно так проявляется практическая польза идемпотентности.
Однако это не разрешение повторять команду бесконечно. Если между двумя командами off пользователь вручную включил свет, вторая команда всё равно может пойти против его намерения. Реальное устройство также может реагировать на повторную команду дополнительными действиями или событиями. Мы проверили только идемпотентность изменения булева значения в имитаторе светильника, а не электрическое поведение устройства или все побочные эффекты автоматизаций.
Почему «никого нет» после восстановления может оказаться старым значением
Если при запуске состояние датчика равно off, нужно ещё выяснить: это новое наблюдение, полученное после запуска, или восстановленное старое состояние?
В эксперименте наблюдение должно удовлетворять трём условиям:
Явно сообщается, что никого нет
Время получения сообщения не раньше текущего запуска
К моменту проверки наблюдение не старше заданного моделью окна актуальности
Скрипт использует окно в 30 модельных единиц времени только для проверки граничных случаев. Это не рекомендация устанавливать для всех реальных устройств порог в 30 секунд. На практике порог следует выбирать с учётом периодичности сообщений устройства и последствий для конкретной задачи.
В эксперименте старое значение off, полученное до запуска, а также unknown, on и значение off за пределами окна не приводили к вызову команды выключения. Действие разрешалось только при новом сообщении off, укладывающемся в окно актуальности.
Здесь обнаруживается и практическая сложность интеграции: одни устройства сообщают только об изменении состояния, другие интеграции восстанавливают данные из кеша, а чтение состояния не обязательно означает непосредственный запрос к устройству. Поэтому нельзя предполагать, что какое-то временное поле любой сущности доказывает: «оборудование только что снова подтвердило отсутствие людей». При подключении конкретного устройства нужно проверить источник данных. Если надёжного нового наблюдения получить нельзя, следует продолжать ожидание или передать решение человеку.
Значения unknown и unavailable нельзя превращать в «никого нет» проверкой вида «не равно on».
Ответ старой задачи не должен сбрасывать новую
Пользователь может задать новое, более позднее время выключения, пока первый обратный отсчёт ещё не закончился. Если старый обратный вызов после этого просто установит глобальный pending в false, он может заодно сбросить новую задачу.
В эксперименте задачам присваиваются разные ID, а обновление выполняется с условием:
UPDATE job
SET state = 'done'
WHERE id = ? AND state = 'pending';
При создании новой задачи старая ожидающая задача сначала отменяется, затем вставляется новая; оба действия выполняются в одной транзакции SQLite. Уведомление о завершении старой задачи содержит только её ID и не может отметить новую задачу как завершённую.
В эксперименте у старой задачи ID 1 и время выполнения 600, а у новой — ID 2 и время выполнения 900. После поступления обратного вызова старой задачи в момент 700 нет задачи, которую можно выполнить, а в момент 901 задача 2 по-прежнему доступна.
Но ID задачи защищает только учёт. Он не может отозвать старую команду, уже отправленную устройству. Если старый запрос ещё находится в сети, новая задача уже создана, а устройство выполнит старый запрос позже, результат всё равно может противоречить новому намерению пользователя. В реальной системе нужно дополнительно изучить последовательное выполнение, семантику отмены и проверку версии на стороне исполнителя. Используемая здесь модель с одним исполнителем не решает проблему параллельных команд в сети.
Какие проверки нужны при подключении к Home Assistant
Помимо обычного срабатывания по времени, нужно как минимум предусмотреть проверку после запуска и после восстановления ключевых сущностей. Можно также добавить редкую фоновую проверку на случай пропущенного сигнала. При каждой проверке следует читать состояние задачи: сам факт запуска проверки не означает, что действие нужно выполнять.
Официальная документация Timer прямо указывает: включение restore позволяет восстановить активные или приостановленные таймеры, но для таймеров, срок которых истёк во время остановки, событие timer.finished при запуске не отправляется.[2] Документация по триггеру состояния также прямо говорит, что отсчёт for сбрасывается при перезапуске или перезагрузке автоматизаций.[3]
Эти факты обосновывают необходимость проверки при восстановлении, но не делают автоматически безопасным следующее правило:
Текущее время позже старого времени выполнения → безусловно выключить свет
При восстановлении нужно одновременно проверить, что задача всё ещё действительна, целевое устройство существует, текущие условия позволяют выполнить действие, сведения о состоянии достаточно свежие и нет явного ручного вмешательства пользователя.
Для ситуаций с недостоверными часами, длительной недоступностью устройства и повторяющимися сбоями также нужно определить, когда прекращать автоматические попытки. В этой модели нет ограничения на число повторных попыток, увеличивающихся интервалов между ними или оповещений. Перед реальным подключением их необходимо добавить: нельзя отправлять команды бесконечно.
Какие выводы можно воспроизвести
Прилагаемый файл: deadline_lab.py. Он использует стандартную библиотеку Python 3. Временная база данных SQLite удаляется после запуска. Токен Home Assistant не требуется, к реальным устройствам скрипт не обращается.
python deadline_lab.py
При этом запуске проверки утверждений для четырёх групп сценариев прошли успешно. Результаты сохранены в deadline_results.json:
| Сценарий | Что подтверждено |
|---|---|
| Закрыть и снова открыть базу данных, затем проверить условия | Ожидающая задача сохраняется; старое, неизвестное, указывающее на присутствие людей и устаревшее наблюдения блокируют действие; допустимое новое наблюдение вызывает действие один раз |
Прерваться после действия, но до записи о завершении, затем повторить off |
Команда действительно вызывается дважды; имитатор светильника в итоге выключен |
Прерваться в тот же момент, затем повторить toggle |
Команда действительно вызывается дважды; имитатор светильника в итоге включён |
| Новая задача заменяет старую, после чего приходит ответ старой | Ответ старой задачи не завершает новую |
Эти четыре группы результатов не доказывают сохранность данных при отключении питания, не доказывают, что вспомогательные элементы Home Assistant обладают транзакционной семантикой SQLite, и не доказывают корректность при нескольких параллельных исполнителях. В эксперименте намеренно оставлен промежуток «действие выполнено, но состояние не сохранено», чтобы показать, почему одного локального учёта недостаточно для обещания выполнить действие ровно один раз.
Для обычного домашнего света часто приемлемо после восстановления сначала подтвердить текущие условия, при необходимости повторно отправить явную команду выключения и предоставить возможность отмены. Для списания денег, отпирания замка или разовой подачи материала, где произвольное повторение недопустимо, такой компромисс может совершенно не подходить.
При проектировании задачи по таймеру важно прямо ответить на вопрос: когда система забыла результат действия, что для вас менее допустимо — пропустить его или выполнить повторно? Только после этого у логики восстановления появится проверяемая цель.
Источники
Дата проверки: 2026-11-14. На официальной странице указана версия Home Assistant 2026.11.1; эта версия в эксперименте не устанавливалась.
- Input Datetime: восстановление состояния.
- Timer: восстановление и ограничения при истечении срока во время остановки.
- State changed: поведение
forпри перезапуске. - Скрипт эксперимента и исходные результаты: программная модель, действительно запущенная в рамках этой работы, и её вывод.
Статья подготовлена, исследована и проверена при содействии ИИ. Модельное время, имитатор светильника и искусственно вызванное прерывание не равнозначны испытаниям в реальных домашних условиях.
Скачать полный пакет эксперимента (скрипт, результаты и журнал запуска)
Концептуальная иллюстрация создана ИИ, это не снимок эксперимента.
Обсуждение
Задайте вопрос или поделитесь опытом. Комментарии появляются после проверки. Адрес почты не публикуется. Конфиденциальность комментариев
Загрузка комментариев…