看懂 HA 的錯誤訊息，自己就能解掉一半的問題

charles

貼求助文之前，先看一下日誌。很多錯誤訊息其實講得很清楚。



怎麼看日誌

設定 → 系統 → 日誌，右上角可以切換到「完整日誌」。

用瀏覽器 Ctrl+F 搜尋 ERROR 最快。

一個關鍵技巧：對時間

日誌會一直滾，裡面有一大堆跟你無關的舊錯誤。

先確認你的問題是幾點發生的，只看那個時間前後的紀錄。

我看過很多人貼了一整頁日誌，結果九成是三天前的東西，完全無關。

常見訊息對照

「Unable to connect」「Failed to connect to host」
→ 裝置離線或 IP 變了。
先 ping 那個 IP 看看，然後去路由器確認它的 IP 是不是換了。
解法：幫重要裝置設 DHCP 保留。

「Entity not available」「unavailable」
→ 整合載入失敗，或裝置沒電。
去「設定 → 裝置與服務」看那個整合有沒有紅字。

「Template error: ... has no attribute ...」
→ 範本要拿的屬性不存在。
去「開發者工具 → 狀態」點那個實體，確認屬性名稱對不對（常常是大小寫或底線錯）。

「Setup failed for custom integration」
→ HACS 裝的東西跟新版 HA 不相容。
這在每次大版本更新後特別常見。先在 HACS 裡停用它，重啟，看問題是不是消失。

「Updating X took longer than the scheduled update interval」
→ 某個整合太慢。
常見於網路不穩，或裝置本身反應慢。如果不影響使用可以忽略，或調整輪詢間隔。

「Error doing job: Task exception was never retrieved」
→ 這個比較難查，通常是某個整合內部出錯。
往下看堆疊訊息，找出是哪個整合的名字。

來論壇求助的話

請附上：

• 完整的錯誤段落，不要只貼第一行（原因常常在後面幾行）
  
• 前後各五行的上下文
  
• 用程式碼標籤包起來（編輯器工具列的 <> 按鈕），不然會跑版
  
• 你的 HA 版本和裝置型號
  
• 你已經試過什麼
  

貼之前記得把個資塗掉——日誌裡可能有你的外部 IP、Token、裝置 ID、甚至 Wi-Fi 名稱。

這樣通常一兩個回覆就能解決，不用來回問十次。

有看不懂的錯誤訊息可以貼上來，我們一起看。