Home Assistant 壞掉時的自助排查：五層工具，由淺到深

charles · 發表於 2026-9-21 02:49:32

這篇的內容（15 段）

第一步：先看「修復」面板
第四步：翻原始日誌
打開「顯示原始日誌」
三個實際有用的技巧
常見訊息對照
Entity not available / unavailable
Template error: ... has no attribute ...
Setup failed for custom integration
一個完整的實例：走過五層
幾個比較嚴重的狀況
狀況一：HA 完全打不開
來論壇求助的話，附這五樣
⚠ 貼出去之前一定要塗掉這些
通過這篇的標準
一個一般性的原則

貼求助文之前，有五層工具可以自己先跑一遍。多數人只知道最深的那一層（翻原始日誌），結果在一堆與自己無關的舊錯誤裡耗掉一個晚上 —— 而問題其實在第一層就會被指出來。

這一篇給你一個固定的順序。照順序做，不要跳 —— 每一層都比下一層便宜，而且愈上層愈可能直接給你答案。

第一層：修復（Repairs）面板 —— HA 主動告訴你哪裡壞了
第二層：整合頁面的狀態與診斷檔
第三層：針對單一整合開偵錯記錄（一鍵，會自動下載）
第四層：翻原始日誌
第五層：用 configuration.yaml 的 logger: 抓「開機階段」的問題

最後附上求助時該附什麼，以及貼出去之前一定要塗掉的東西。

第一步：先看「修復」面板

設定 -> 系統 -> 修復。

這是最容易被忽略的一頁。HA 會把自己偵測到的問題放在這裡，而且多半附了處理按鈕：整合認證過期、設定項目已棄用、某個裝置無法連線、資料庫過大、YAML 寫法即將失效。

你會看到：一張清單，每一項左邊是一個圖示、右邊可以點開。點開之後通常是一段說明加上一個「submit」或「重新整理」按鈕。

清單是空的 -> 很好，往下走第二步。空白畫面通常會寫「沒有需要注意的事項」
有橘色或紅色的項目 -> 先處理它們。很多「我的自動化突然不動了」到這裡就結案了

⚠ 修復面板裡的項目不會自己消失。 處理完之後要按關閉或再點一次確認，它才會從清單移除。所以看到舊項目不代表問題還在 —— 但也不要假設它已經好了，點進去看一下。

第二步：到整合頁面看那個裝置的狀態

設定 -> 裝置與服務，找到出問題的那個整合。

你會看到三種情況之一：

卡片上有橘色的驚嘆號或「重新設定」按鈕 -> 認證失效或設定需要更新，點下去照著走
卡片上寫「N 個裝置、M 個實體」但實體數是 0 -> 整合載入了但沒抓到東西，通常是權限或韌體問題
整合根本不在清單上 -> 它載入失敗了。這種情況跳到第四步翻日誌，關鍵字是整合名稱加上 Setup failed

順便抓診斷檔：點整合卡片右上角的三個點，如果有「下載診斷資料」就按下去。裡面是那個整合當下的設定與狀態，求助時附上它，回覆速度差很多。

沒有「下載診斷資料」這個選項是正常的 —— 不是每個整合都有提供，沒提供時選項就不會出現，不是你找錯地方。

⚠ 診斷檔分享出去之前一定要自己先開來看過。 它是純文字檔，裡面可能有你的裝置序號、區域網路結構、甚至權杖。HA 會盡量遮蔽，但不保證遮乾淨。

第三步：針對那一個整合開偵錯記錄

這是最有效率的一招，而且多數人不知道有這個按鈕。

設定 -> 裝置與服務 -> 找到那個整合 -> 右上角三個點
選「啟用偵錯記錄」
回去把問題重現一次（按那個按鈕、等那個自動化跑、拔一下裝置的電）
回到同一個選單，選「停用偵錯記錄」

你會看到：瀏覽器自動下載一個 .log 檔案，檔名帶著整合名稱和時間。

這個檔案的好處是它只有那個整合的內容，而且只有你重現問題的那段時間 —— 不用自己去一大片日誌裡撈，也不用對時間。

停用之後沒有自動下載 -> 瀏覽器擋掉了下載。看網址列右邊有沒有被封鎖的提示。

⚠⚠ 這個按鈕有一個很重要的限制，它是第五步存在的原因

UI 這個開關產生的記錄，只包含那個整合自己寫的訊息。它不含：

以下還有約 81% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

Home Assistant 壞掉時的自助排查：五層工具，由淺到深

延伸閱讀

瀏覽過的版塊