裝置不動了：從最便宜的動作開始的十二步排查流程

charles

這篇的內容（8 段）

1. 先看整體順序
2. 步驟 1：記錄現場
3. 步驟 7：Zigbee 訊號品質
4. 步驟 10：重啟應用程式或容器
5. 最後才：重新配對
6. 第二件：寫一條離線通知
7. 常見狀況對照表
8. 最後：把你查過的寫下來

裝置出問題的時候，最浪費時間的做法是一上來就重新配對。那是整串流程裡最貴的動作，而且十次有八次不是問題所在。這篇把排查排成十二步，順序就是「成本由低到高」—— 每一步都有實際的指令、實際會看到的輸出、以及「看到這個代表問題在哪一層」。



先看整體順序

• 步驟 1 到 2（一分鐘）：記錄現場、分類問題範圍
  
• 步驟 3 到 5（五分鐘）：裝置重開、看日誌、確認它還在網路上
  
• 步驟 6 到 8（十分鐘）：協定層的檢查（Zigbee 訊號、IP、mDNS）
  
• 步驟 9 到 10（五分鐘）：重新載入整合、重啟服務
  
• 步驟 11（最後）：重新配對，而且要保住 entity_id
  
• 步驟 12：加監控，讓下次不用你發現
  

⚠ 最重要的一條規則：一次只改一件事。

同時重開路由器、重啟 Home Assistant、換 Zigbee 頻道、重新配對 —— 就算好了，你也完全不知道是哪一個有用，下次再發生還是不會修。而且其中有些動作有副作用（換頻道會讓整個 Zigbee 網路重新收斂），你會製造出新的問題。

步驟 1：記錄現場

在做任何修復動作之前，花三十秒寫下三件事：

• 幾點幾分發現的（後面查日誌要用）
  
• 症狀的精確描述：是「完全沒反應」、「時好時壞」、還是「狀態卡在某個值」
  
• 最近改了什麼：更新過什麼？換過路由器？新增了什麼裝置？搬動過什麼東西？
  

第三項是命中率最高的線索，而且大多數人不會主動想到。「前天更新了 Zigbee2MQTT」這句話常常就是答案。

⚠ 不要先重開機。 重開會把現場清掉 —— 日誌重來、暫時性的錯誤消失。抓證據只要一分鐘，而重開之後你再也回不到那個現場。

步驟 2：分類 —— 是一台、一類、還是全部？

這一步決定後面要查哪一層，可以省掉一大半無關的檢查。

到 開發者工具 → 模板，把左邊整個換成：

1. 不可用的實體共 {{ states | selectattr('state','in',['unavailable','unknown']) | list | count }} 個
3. {% for s in states | selectattr('state','in',['unavailable','unknown']) | list %}
4. {{ s.entity_id }}
5. {%- endfor %}

複製代碼

你會看到什麼：右邊立刻出現一份清單，例如：

1. 不可用的實體共 4 個
3. binary_sensor.zou_dao_ren_ti
4. sensor.zou_dao_ren_ti_dian_liang
5. sensor.zou_dao_ren_ti_lqi
6. sensor.zou_dao_ren_ti_wen_du

複製代碼

怎麼判讀：

• 清單裡全部都是同一台裝置的實體 → 問題在那台裝置。往步驟 3 走（沒電、太遠、壞了）
  
• 清單裡是同一類的好幾台（全部都是 Zigbee，或全部都是同一個廠牌） → 問題在網關或整合。跳過步驟 3 到 5，直接到步驟 9
  
• 清單很長，什麼都有 → 問題在 Home Assistant 本身或家裡的網路。到步驟 4 看日誌
  
• 清單是空的，但那個裝置就是不動 → 裝置是「在線但不聽話」，這是另一種狀況。跳到步驟 4
  

先分類再查，可以少查很多無關的東西。

步驟 3：把那台裝置的電拔掉再插上

聽起來很蠢，但這一招解掉的問題比例相當高。IoT 裝置的韌體品質參差不齊，跑久了會卡在某個狀態。

⚠ 注意：是拔那個「裝置」的電，不是重開 Home Assistant。 很多人習慣先重開 Home Assistant，但如果問題在裝置端，重開 Home Assistant 一點用都沒有，而且花你五分鐘。

• 插電裝置：拔插頭，等 至少十秒（電容放電），插回去
  
• 電池裝置：把電池拿出來，等十秒，裝回去。順便量一下電壓 —— 鈕扣電池（CR2032）低於 2.8V 就該換，就算 Home Assistant 顯示還有 50%
  

你會看到什麼：把 開發者工具 → 狀態 那一頁開著，裝置重新上線時，實體會從 unavailable 變成正常值。Zigbee 裝置通常要 30 秒到 2 分鐘。

• 回來了 → 問題解決。但記錄下來，如果一個月內又發生，那就是有系統性原因（訊號、電源品質、韌體 bug）
  
• 還是不回來 → 往步驟 4
  

步驟 4：看日誌，而且要對時間

到 設定 → 系統 → 記錄。

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

登入繼續閱讀使用 Google 登入