HA 升級後打不開：從最不痛到最痛的四條路，照順序走

charles

這篇的內容（15 段）

1. 步驟 2：拿到啟動日誌
2. Docker / Container：
3. 步驟 3：讀日誌，對號入座
4. 狀況 A：設定檔語法錯
5. 狀況 C：資料庫升級失敗
6. 步驟 4：進安全模式
7. 方式一：還登得進介面
8. 步驟 6：設定檔語法錯
9. 步驟 8：還原備份
10. 8-1. 先確認你有加密金鑰
11. 1. 升級前手動按一次備份
12. 3. 不要一看到更新就按
13. 4. 升級前掃一次重大變更
14. 5. 有一台測試機更好
15. 最後一件事

升級後進不去 Home Assistant，九成的情況資料完全沒事，只是啟動被某個東西卡住。這一篇把處理順序排成四條路，從「完全不動資料」排到「重灌」，每一步都告訴你成功長什麼樣、失敗長什麼樣。

先看這裡：不要一上來就還原備份。 還原會把你升級之後做的所有設定一起丟掉，而多數情況根本不需要走到那一步。



步驟 1：先分辨你遇到的是哪一種「打不開」

打開瀏覽器連你的 Home Assistant 網址，看實際的症狀：

• 瀏覽器說「無法連線」「連線被拒絕」 → Core 根本沒起來。走步驟 2
  
• 一直轉圈圈，或是 502 → 正在啟動中。先等五分鐘再說。資料庫升級可能要跑十幾分鐘，這期間它是真的在工作
  
• 登得進去，但一堆實體不見或變成 unavailable → Core 沒事，是某個整合掛了。走步驟 2 看日誌，多半不用還原
  
• 登得進去，畫面上方有一條黃色橫幅寫著安全模式或復原模式 → HA 自己發現有問題並降級啟動了。走步驟 4
  
• 登得進去，只有某一個功能壞掉 → 不用還原，直接走步驟 2 找那個整合的錯誤
  

⚠ 升級後打不開時，第一個動作是取得日誌，不是還原。 沒有日誌就還原，等於你永遠不知道為什麼壞，下次升級會再壞一次。

步驟 2：拿到啟動日誌

HA OS / Supervised：接螢幕鍵盤，或用 SSH

HA OS 的主機接上螢幕和鍵盤，會看到一個 `ha >` 的提示字元。輸入：

1. ha core logs

複製代碼

要一直跟著看就用：

1. ha core logs --follow

複製代碼

⚠ 不要去找 /config/home-assistant.log

舊教學都叫你去讀這個檔。HA OS 自 2025.11 起預設不再寫它，日誌改走系統的 journal。你會找到一個不存在的檔案，然後以為問題嚴重到連日誌都沒了。

想把它開回來（平常就先開著，出事的時候會很感謝自己）：

1. ha core options --duplicate-log-file=true
2. ha core rebuild
3. ha core restart

複製代碼

你會看到這三行各跑幾秒到幾分鐘，跑完之後 `/config/home-assistant.log` 才會重新出現。

這個要在系統還正常的時候先開，等打不開了才想開，那時候你也下不了指令。

Docker / Container：

1. docker logs -f homeassistant

複製代碼

`ha` 指令回「command not found」，代表你是 Container 安裝，沒有 Supervisor，本篇所有 `ha` 開頭的指令都要換成 `docker` 的對應做法。

步驟 3：讀日誌，對號入座

錯誤幾乎都在最後 30 行。往上捲，找 ERROR 或 Traceback 開頭的那幾行。

最常見的三種：

狀況 A：設定檔語法錯

1. ERROR (MainThread) [homeassistant.config] Invalid config for 'sensor' at
2. configuration.yaml, line 87: required key 'platform' not provided

複製代碼

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

登入繼續閱讀使用 Google 登入