智能家居 ·

Home Assistant 定时关灯的真正难点:重启后补执行,为什么可能执行两次?

通过 SQLite 与模拟灯具的故障注入实验,分析跨重启定时任务的漏执行、重复执行、状态新鲜度与旧回执问题,附脚本和原始结果。

更新于

上一篇讨论了 Home Assistant 重启会打断 for 和正在运行的延时。最自然的修复建议,是把截止时间保存下来,启动后检查过期任务。

但截止时间只解决了“什么时候应该做”。还有一个更难的问题:动作做完了,系统却没来得及记下完成,这时重启应该怎么办?

如果重试,可能重复执行;如果不重试,可能漏掉一个其实尚未执行的任务。这个矛盾,不会因为把时间写进辅助元素就自动消失。

这篇用 SQLite 和一个模拟灯具做故障注入实验,讨论普通照明场景下的取舍。脚本已经实际运行,但不是 Home Assistant 集成测试,也没有控制你家里的设备。文章给出的状态机是设计参考,不是可以直接粘贴的完整 YAML。

首先分清两条看起来相同的规则

“十分钟后关灯”可能表达两种业务含义:

规则 关心的事实 停机造成的缺口
房间连续无人十分钟后关灯 整段时间都无人 停机期间有没有人进来,系统可能不知道
用户启动十分钟倒计时,到期尝试关灯 截止时间及执行时条件 截止时间可能错过,执行结果可能没有记录

这两条规则不能互换。

对于第一条,恢复一个过去的时间戳,不能证明停机期间持续无人。如果没有独立、可靠的传感器历史,保守策略应是重新观察一段时间。

本文的实验针对第二条:用户明确创建一项定时关灯任务,到期后只有取得足够新的“无人”观测,才尝试关闭普通测试灯。 它没有声称复原了停机期间的连续占用情况。

为什么单个时间辅助元素还不够

Home Assistant 的 input_datetime 可以存日期和时间。官方说明:设置有效 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 Token,不访问真实设备。

python deadline_lab.py

本次 4 组场景断言通过,结果保存为 deadline_results.json:

场景 验证到的事实
关闭并重新打开数据库,再检查条件 待执行任务保留;旧、未知、有人和过期观测被拦截;有效新观测触发一次动作
动作后、完成写入前中断,重试 off 实际调用两次,模拟灯最终关闭
同样中断,重试 toggle 实际调用两次,模拟灯最终打开
新任务替换旧任务,旧回执随后到达 旧回执不会完成新任务

这四组结果不证明断电持久性、不证明 Home Assistant 的辅助元素具备 SQLite 事务语义,也不证明多执行者并发正确。实验甚至刻意保留了“动作已执行但状态未提交”这一缺口,用来展示为什么仅靠本地记账无法承诺恰好执行一次。

对于家里的普通灯,我们往往能接受:恢复后先确认当前条件,必要时再次发送明确的关灯指令,并提供取消入口。对扣款、开锁、一次性投料等不可随意重复的动作,同样的取舍可能完全不成立。

设计定时任务时,真正需要明确的是:在系统忘记了动作结果的那一刻,你更不能接受漏做,还是更不能接受重复做?只有把这一点写清楚,恢复逻辑才有可验证的目标。

参考资料

核对日期:2026-11-14。官方页面显示 Home Assistant 2026.11.1;实验没有安装这个版本。

  1. Input Datetime:Restore state。
  2. Timer:恢复与停机到期限制。
  3. State changed:for 的重启行为。
  4. 实验脚本和原始结果:本次实际运行的软件模型及输出。

本文由 AI 辅助研究、编写和验证。模拟时间、模拟灯具与注入中断不等同于真实家庭环境测试。

下载完整实验包(含脚本、结果和运行记录)

AI 生成的概念配图,不是本次实验截图或实测照片。