修不好要問人之前：把日誌、診斷檔抓齊並遮掉敏感資料的完整做法

charles

這篇的內容（11 段）

1. 先講一個很現實的事
2. 第一步：固定重現步驟
3. 第二步：記下環境資訊
4. ⚠ 不要用 homeassistant: debug: true
5. 第七步：下載診斷檔
6. 第八步：遮蔽敏感資料
7. 第九步：組成報告
8. 第十步：貼到論壇的技術細節
9. 第十一步：解決之後回填
10. 常見錯誤訊息的意思
11. 最後：抓證據的順序不要搞反

「我的感應器不會動，怎麼辦？」—— 這種貼文沒人回，不是大家不想幫，是看的人要先問十個問題才能開始。這篇不談禮貌，談操作：Home Assistant 的日誌在哪、怎麼只對一個整合開偵錯記錄、診斷檔怎麼下載、Zigbee2MQTT 和 ESPHome 的日誌各自在哪、哪些欄位一定要遮掉，以及一支可以直接跑的遮蔽腳本。



做完這一篇你會有一份可以直接貼出去的報告：重現步驟、環境版本、兩段關鍵日誌、一個診斷檔、以及一份已經確認沒有洩漏任何私人資訊的附件。

先講一個很現實的事

一份完整的報告不只是給別人看的。把證據整理一次的過程，本身就解掉了相當比例的問題 —— 因為整理的時候你會被迫回答「這是什麼時候開始的」「我最近改了什麼」，而答案常常就在那裡。

所以就算最後你沒有貼出去，這十個步驟也值得走一次。

第一步：固定重現步驟

在抓任何日誌之前，先寫下三行：

• 我做了什麼（具體到動作：在 App 裡按客廳燈的開關）
  
• 我預期會發生什麼（燈亮）
  
• 實際發生什麼（燈沒亮，App 裡的按鈕跳回關閉狀態）
  

然後最重要的一題：這件事我能不能重複做出來？

• 每次都這樣 → 最好處理，後面每一步都能抓到現場
  
• 偶爾才這樣 → 要先把偵錯記錄開著放一段時間（第四步會講）
  
• 只發生過一次 → 只能靠事後的日誌（第三步），而且時間點要抓準
  

你會看到什麼：三行文字，加上一個明確的時間 —— 幾點幾分發生的。這個時間後面每一步都會用到，日誌裡有幾萬行，沒有時間你找不到。

第二步：記下環境資訊

到 設定 → 系統 → 修復，右上角三個點，選 系統資訊。

你會看到什麼：一整頁的版本資訊。要抄下來的是：

• Home Assistant Core 版本（例如 2026.9.3）
  
• 作業系統版本（例如 Home Assistant OS 18.3）
  
• 安裝類型（Home Assistant OS / Container / Core）
  
• Python 版本與架構（aarch64 / amd64）
  

這一頁右上角通常有一個複製按鈕，按下去會把整段用表格格式複製到剪貼簿，直接貼進報告就好，不要自己抄。

安裝類型為什麼重要：同一個問題，HA OS 的解法是「裝一個應用程式」，Container 的解法是「改 docker-compose」，Core 的解法是「pip install」。沒寫安裝類型，別人給你的答案有三分之二機率是你用不了的。

第三步：抓 Home Assistant 的系統日誌

到 設定 → 系統 → 記錄。

上方有一個下拉選單，預設是 Home Assistant Core。這個選單可以切到各個應用程式（Zigbee2MQTT、ESPHome、Mosquitto、Supervisor 等），第六步會用到。

先看 Core 的：

• 畫面上半部是整理過的錯誤摘要，每一則可以展開看完整堆疊訊息
  
• 按右上角的 顯示原始記錄，會切換成一大片未整理的文字，那才是完整的
  
• 旁邊有下載按鈕，會存成一個 .log 檔
  

你會看到什麼：原始記錄長這樣：

1. 2026-09-25 18:42:11.331 WARNING (MainThread) [homeassistant.components.mqtt.client] Disconnected from MQTT server 192.168.1.10:1883 (rc: 7)
2. 2026-09-25 18:42:16.004 ERROR (MainThread) [homeassistant.components.zha] Error handling message: Device 0x8a3f did not respond
3. 2026-09-25 18:42:16.008 DEBUG (MainThread) [zigpy.application] Received frame: ...

複製代碼

怎麼在幾萬行裡找到你要的：用瀏覽器的頁內搜尋（Ctrl+F）搜第一步寫下的那個時間，例如 18:42。找到之後，往前抓十行、往後抓十行一起複製。

不要只貼第一行紅字。 真正的原因常常在後面幾行的堆疊訊息裡，而最上面那行往往只是「某某東西失敗了」這種沒有資訊的句子。

• 整片日誌只有 INFO 和 WARNING，沒有任何 ERROR → 代表 Home Assistant 這一側沒有察覺到錯誤，問題在裝置端或網路端。這本身就是一個重要的線索，要寫進報告
  
• 日誌的最早一行只到幾小時前 → 正常。Home Assistant 重啟時日誌會重來。問題發生在重啟之前的話，要改用第五步的 ha CLI 去翻舊的
  

第四步：只對一個整合開偵錯記錄

預設的日誌等級是 warning，也就是說 info 和 debug 等級的訊息根本沒有被寫下來。大部分「日誌裡什麼都沒有」的情況就是這樣來的。

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

登入繼續閱讀使用 Google 登入