Home Assistant は「実行成功」と表示するのに、なぜライトは点かないのか?

Home Assistant は「実行成功」と表示するのに、なぜライトは点かないのか?

オートメーションを作成し、「アクションを実行」を押すとライトが点いた。ところが夜になり、実際にドアを開けても反応しない。

逆のことも起こり得る。トレースにはライトを点けるステップまで実行されたと表示され、目立ったエラーもないのに、部屋は暗いままだ。

この二つの仮定上の場面は、どちらも「オートメーションが不安定」に見えるが、確認すべき箇所は同じではない。手動テストで確認できる範囲、実際のトリガー条件、アクションが選んだ対象、機器の実際の反応を、一つずつ切り分ける必要がある。

本記事は、確認時に 2026.11.1 と記載されていた Home Assistant の公式ドキュメントに基づいており、家庭内の機器を使った実機テストは含まない。バージョンによってメニュー名は変わる可能性がある。重要なのは、それぞれのテストが何を証明するのかを理解することだ。

「アクションを実行」ではオートメーション全体をテストできない

オートメーションは通常、トリガー、条件、アクションで構成される。例えば、ドアが開き、かつ日が沈んでいれば、玄関のライトを点ける。

エディターで「アクションを実行」を選ぶと、トリガーとオートメーションのトップレベルの条件を飛ばして、アクションのシーケンスを直接実行する。ただし、choose の分岐にある判定など、アクションのシーケンス内の条件は引き続き適用される。[1]

したがって、手動で押してライトが点いたとしても、今回のアクション実行でライトを点けられたことが分かるだけだ。ドアを開けたときにトリガーされることも、実際の実行時に条件を満たすことも証明していない。

公式ドキュメントによると、この実行には実際のトリガーデータもトリガー ID もない。アクションの分岐が「どのトリガーによって起動したか」に依存している場合、手動実行と実際の実行では経路が異なる可能性がある。[1]

テスト方法 主に確認できること 併せて証明できないこと
アクションを一つだけ実行する 現在の条件下でそのアクションを実行できるか それ以前の変数やトリガーデータが正しいか
すべてのアクションを実行する アクションのシーケンスと、その中の条件 実際のトリガーとトップレベルの条件が正常に機能するか
条件を一つだけテストする 現時点でその判定を通過するか 実際にトリガーされたときにも通過するか
実際のイベントでトリガーする その回の実行経路全体と機器の挙動 あらゆる時刻や故障の場面でも確実に動作するか

最初に適切なテスト方法を選べば、問題のない設定をむやみに変更せずに済む。

まず該当する回のトレースを探し、現在の状態だけを見ない

Home Assistant のトレースには、トリガー、条件判定、アクション、関連する変数が記録される。公式のトラブルシューティング文書も、まずトレースを確認することを勧めている。[1][2]

問題が夜 8 時に起きたなら、その時刻の実行を開くべきだ。現在、条件の横に緑色の表示が出ているかどうかだけを見てはいけない。今は日が沈んでいても、当時のテストで条件を満たしていたとは限らない。

まず、その実行が始まったかを確認する。該当する実行がなければ、オートメーションが有効か、また入力に監視対象の変化があったかを調べる。公式ドキュメントには、オートメーションが無効でも手動でアクションを実行できると明記されている。つまり「ボタンでは動く」ことは、オートメーションが有効である証拠にはならない。[2]

実行が始まっていたなら、トレースに沿って、どこで経路が終わったかを見る。条件を満たさずに止まったなら、それは論理判定の結果だ。アクションのエラーで止まったなら、対象とパラメーターを確認する。どちらも「遅延を長くする」だけで一律に対処できる問題ではない。

画面上の表示と生の状態の違いにも注意したい。ドアセンサーの画面には「開」と表示されていても、状態トリガーが実際に比較する値は on かもしれない。画面に表示された日本語をそのまま状態文字列にすると、一致しない可能性がある。[2]

エラーがないのは、操作できるライトが選ばれていないだけかもしれない

アクションが「書斎エリアのライトを点ける」だとしても、書斎エリアにそのアクションが対象として認識するライトエンティティがない場合を考えてみよう。公式のトラブルシューティング文書によると、対象に一致するエンティティがない場合、エラーを出さずにスキップされることがある。[2]

そのため、アクションが最後まで進んでいても、実際に何が選ばれたかを確認する必要がある。機器が属するエリアを変更した、新しいラベルを使った、あるいはスイッチをライトと取り違えた場合などは、見直す価値がある。

診断時には、一つの明確なライトエンティティを指定して、小さな範囲で一時的にテストできる。そのライトを直接操作すると正常に動き、エリアやラベルを介すと動かないなら、まず対象の集合を確認する。この方法は問題の範囲を絞るためのものであり、最終的にすべてのエンティティを固定指定すべきだという意味ではない。

エンティティが unavailable なら、電源、接続、インテグレーションの状態を調べるべきだ。対処のされ方はインテグレーションによって異なる可能性がある。利用できないエンティティをスキップして警告を記録するものもあれば、コマンドを送信したうえでエラーを報告するものもある。[2]

最終的には、ライトが実際に変化したかを観察する必要がある。アクションの呼び出しが完了しただけでは、現実のライトが期待した状態になったとは証明できない。

全体の実行が完了しても、途中で失敗していないとは限らない

Home Assistant では、アクションでエラーが発生した後も実行を続けられる。公式ドキュメントによると、Continue on error を有効にしている場合、途中のアクションが失敗しても後続のアクションが実行され、実行全体も終了することがある。[2]

例えば、先にライトを点け、次に通知を送るというサンプルの流れを考える。ライトの点灯に失敗しても処理を続ければ、「処理が終了した」という通知を受け取り、ライトも点いたと思い込みやすい。

この場合は、最後の通知だけを見るのではなく、ライトを点けるステップのエラー情報を確認すべきだ。結果のフィードバックが必要な処理では、「リクエストを送信した」と「対象が期待した状態になったことを確認した」を区別する必要もある。

エラー後も実行を続けるかどうかは、アクション間の依存関係に応じて設計する。ライトの点灯に失敗した後で故障通知を送るのは有用だ。一方、点灯に失敗したのに「照明を点けました」と通知すれば、利用者を誤解させる。

状態のシミュレーションは、紙の上だけのテストではない

公式ドキュメントには、状態変化やイベントをシミュレーションするテスト方法が示されている。これらの方法ではオートメーションにトリガーデータを渡せるため、トリガーに依存する分岐の確認に適している。[1]

ただし、重要な点がある。状態ツールでエンティティの状態を変更しても、それ自体によって物理的な機器の状態は変わらない。一方、その状態変化が実際のオートメーションをトリガーし、結果として実機を制御する可能性はある。[1]

そのため、ドアセンサーが開いた状態をシミュレーションする前に、それを監視しているほかのルールを把握しておくべきだ。玄関のライトをテストするつもりで、外出モードや警報など、一連の連動処理まで起動させないようにする。まず独立したテスト用エンティティとテスト用ルールを使い、影響範囲を確認してから実際の経路を検証できる。

シミュレーション後は、機器が再び状態を報告するまで、画面上の状態と機器の実際の状態が一時的に食い違う可能性もある。後から実際のセンサー記録と取り違えないよう、テスト記録にはシミュレーションデータであることを明記したい。

一回分の完全な記録でトラブルシューティングを締めくくる

役に立つ記録は簡単なものでよい。いつ何をしたか、入力エンティティが何を報告したか、どのオートメーションがトリガーされたか、どの条件を満たし、どの条件を満たさなかったか、最終的にどのエンティティを制御し、機器が反応したかを記録する。

まず個別のアクションを検証し、次に条件と分岐を検証し、最後に実際のイベントで一通り実行する。対象の指定ミスだと特定できたなら、まず対象を修正する。トリガーされていないことが明らかなら、入力を調べ直す。センサーとネットワークを同時に入れ替える必要はない。

人がまだいるのにライトが消される問題なら、続けて自動消灯のタイマーと在室判定を参照できる。二つのトラブルシューティングは関連するが、どちらもライトの挙動がおかしいからといって、原因が同じだと決めつけてはいけない。

「実行成功」は参考になる。しかし、その回にライトがなぜ点いたのか、あるいはなぜ点かなかったのかを説明できてこそ、トラブルシューティングが本当に完了したと言える。

参考資料

確認日:2026 年 11 月 11 日。

  1. Home Assistant:Testing automations、ステップごとのテスト、アクションの実行、トリガーデータ、入力のシミュレーション、トレース。
  2. Home Assistant:Troubleshooting automations、無効状態、生の状態、対象が空の場合、機器が利用できない場合、エラー後の実行継続。

AI生成の概念図です。実測写真やネットワーク構成図ではありません。

コメント・議論

質問や実践の経験をお寄せください。コメントは承認後に表示されます。メールアドレスは公開されません。 コメントのプライバシー

コメントを読み込み中…