智能家居
Home Assistant 自动化不触发怎么查:Trace 追踪、模板调试与日志定位实战
2026年11月22日
用Trace、模板调试与日志三步定位HA自动化故障。
Home Assistant 自动化不触发怎么查:Trace 追踪、模板调试与日志定位实战
摘要:自动化写了却不执行,问题通常藏在触发器边界、条件判断或动作调用三个环节。本文用 Home Assistant 自带的 Trace、开发者工具模板和分级日志,把"猜"变成可复现的排查流程。
先分清"没触发"和"触发了但没动作"
打开 automations 页面,查看目标自动化的"上次触发"时间。若有记录但灯没亮,问题在条件或动作;若始终没有记录,问题在触发器。很多所谓失灵其实是触发条件从未满足:例如 numeric_state 触发器只在数值跨越阈值时动作,设备重启后温度已经低于 18 度,系统不会因为"当前仍然低于阈值"而补触发。这类需求应改用状态变化加条件判断,或在启动时额外检查一次。
第一步:用 Trace 逐步回放
在自动化详情页右上角选择"追踪",可以看到每次执行的时间线:触发器数据、每一个 condition 的布尔结果、每个服务的调用参数都能展开。重点看两点:条件节点若显示 false,直接定位是哪一条条件没过;动作节点若报 service call failed,把报错中的 entity_id 与实际实体核对。Trace 显示的是渲染后的真实值,包括当时的传感器状态,这比事后回忆可靠得多。默认保留最近若干次记录,排查时先手工触发一次再立刻查看,避免记录滚动丢失。
第二步:在开发者工具里验证模板
很多条件写成模板后看似合理,实际返回 unknown。进入开发者工具的模板页,逐条粘贴验证:
{{ states('sensor.living_temp') }} {{ is_state('binary_sensor.door', 'on') }} {{ states('sensor.living_temp') | float(0) < 18 }}
这里有三个高频坑。其一,states() 在实体不可用时返回字符串 unavailable,直接与数字比较会抛异常,务必用 | float(0) 或 | int(0) 兜底。其二,实体 ID 拼错不会报错,只会返回 unknown,条件静默失败,因此复制实体 ID 而不是手打。其三,时间条件不要拿字符串做大小比较,应使用 today_at('07:00') 或 as_timestamp() 转成统一类型。模板验证通过后,再放回自动化,能排除大半"条件明明满足却不执行"的情况。
第三步:分级日志补上盲区
在 configuration.yaml 中临时提高相关模块日志级别:
logger: default: warning logs: homeassistant.components.automation: debug homeassistant.helpers.condition: debug
执行 homeassistant.reload_core_config 使其生效,复现一次问题后到日志页筛选 automation 关键词。若是 MQTT 设备,另开一个终端用 mosquitto_sub -t 'home/#' -v 独立验证消息是否真的上报,避免把设备离线误判为自动化故障;Zigbee 设备则先确认节点状态为 online。定位完成后把日志级别调回,避免调试日志长期占用磁盘。
四类典型案例
案例一:人在传感器一直处于 on,自动化配的是"从关到开",因此永远不触发。改为状态变化触发加当前状态条件即可。案例二:条件写 {{ now().hour > 22 or now().hour < 6 }} 却忘了分钟边界,跨天时段判断错乱,改用 today_at 生成起止时间。案例三:动作中 entity_id 填了界面显示的中文名称而非实体 ID,服务调用不报错但设备无反应,Trace 里能看到参数。案例四:设了 for: 00:05:00 但传感器频繁抖动,计时器不断重置;先加合理的去抖延迟或过滤条件,让状态稳定后再开始计时。
上线前养成三个习惯
自动化命名带上用途与房间,方便在 Trace 列表中快速定位;条件尽量少而明确,复杂表达式先在模板页验证;关键场景用 choose 加默认分支,失败时推送通知,而不是静默失败。把这三点与 Trace 结合,排障时间可以从数小时压缩到十几分钟。
小结
排查顺序建议固定为:先看上次触发时间区分触发器与条件问题,再用 Trace 回放每一步的真实数据,然后到模板页验证表达式,最后用分级日志和协议层工具补盲。这个流程不依赖第三方插件,适用于大多数 Home Assistant 安装方式。