孙亮亮
返回 智能家居

智能家居

Home Assistant 自动化不触发怎么查:Trace 追踪、模板调试与日志定位实战

2026年11月22日

用Trace、模板调试与日志三步定位HA自动化故障。

Home Assistant自动化排障Trace模板智能家居

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 安装方式。

本模块其他文章

智能鱼缸水族箱控制器 DIY:ESP32 水温/pH 监测 + 加热棒水泵灯光接入 Home Assistant 实战阳台智能自动浇灌系统:ESP32 + 土壤湿度 + 电磁阀接入 Home Assistant 实战全屋多房间背景音乐同步:Snapcast + MPD + Home Assistant 打造分布式音频中枢智能家居语音播报通知中枢实战:用 Home Assistant + TTS 让音箱主动播报天气提醒与告警旧平板手机改造家庭控制面板:Home Assistant Kiosk 模式、Fully Kiosk 与快捷卡片实战Home Assistant 配置备份与灾难恢复实战:全量快照、加密外备与一键回滚智能家居 Zigbee 网络优化实战:信道规划、路由节点布点与离网自愈避坑全屋智能场景模式中枢实战:用 input_select + scene 编排离家/回家/睡眠/就餐一键模式智能家居温控自动化实战:空调伴侣与地暖接入 HA、基于人在感应做节能控温智能家居照明控制实战:零火/单火智能开关选型、灯带接入 Home Assistant 与情景模式联动智能家居空气质量监测实战:ESPHome + PMS5003/ENS160 监测 PM2.5、CO₂ 与 TVOC 并联动新风净化把米家/涂鸦设备接入 Apple HomeKit:Homebridge 桥接与本地控制实战Home Assistant 蓝牙代理实战:ESP32 蓝牙中继扩展米家/涂鸦 BLE 设备覆盖Home Assistant 接入 Matter 设备实战:Thread 边界路由、多生态互通与本地自动化ESPHome 智能插座能耗监测实战:待机功耗摸底、定时断电与 Home Assistant 电费看板用 ESPHome 红外万能遥控把传统空调电视纳入 Home Assistant:码值学习与场景联动实战智能家居窗帘光照联动实战:ESPHome 电机 + 光照传感器 + HA 日出日落自动化智能门锁与门禁接入 Home Assistant:指纹锁状态同步、临时密码与回家离家自动化智能家居漏水与燃气安全监测实战:ESPHome 传感器接入 Home Assistant 并自动关阀告警毫米波雷达存在检测接入 Home Assistant:LD2410 + ESPHome 解决人体感应误触发与无人区漏检Home Assistant 离线语音助手搭建:Whisper 语音识别 + Piper 中文 TTS 本地控制全屋把 Aqara/米家 Zigbee 设备接入 Home Assistant:ZHA 网关配置与回家离家自动化实战ESPHome 从零打造 WiFi 温湿度传感器并接入 Home Assistant:固件编译、配网与自动化联动Home Assistant 本地部署与 MQTT 设备接入实战:从 Docker 安装到自动化规则家庭能耗监测实战:用智能插座 + Home Assistant 把每月电费拆到每个电器毫米波人体存在传感器实战:彻底解决智能灯"人不动就关"的尴尬回家即亮灯、离家自动布防:用 Home Assistant 把场景自动化串起来Zigbee 还是 Matter?智能家居协议选型Home Assistant 本地优先实践
Home Assistant 自动化不触发怎么查:Trace 追踪、模板调试与日志定位实战 · 孙亮亮