HA 升級的正確流程：怎麼升才不會壞

charles

HA 每個月一個大版本，升級是常態。

這篇講一套不會出事的流程。



升級前：五分鐘的準備

一、看 Release Notes

• 設定 → 系統 → 更新 → 點那個版本
  
• 或者去 HA 官網的 blog
  
• 重點看「Breaking Changes」那一段
  

Breaking Changes 的意思是「這些東西會壞」 ——
看一下有沒有你在用的。

二、做一次完整備份

• 設定 → 系統 → 備份 → 建立備份
  
• 確認備份成功（看檔案大小）
  
• 虛擬機的話可以拍快照（更快）
  

三、檢查設定檔

1. 設定 → 開發者工具 → YAML → 檢查設定

複製代碼

或者 SSH：

1. ha core check

複製代碼

升級前設定就有問題的話，升完更難查。

四、看 HACS 有沒有更新

• 很多自訂整合會先更新以支援新版 HA
  
• 先更新 HACS 的東西，再升級 HA
  

五、挑時間

• 不要在出門前升級
  
• 不要在半夜（萬一壞了燈全暗）
  
• 週末早上最好
  

升級中

• 點更新，然後等
  
• 通常 5-15 分鐘
  
• 不要中途斷電或重開
  
• 介面可能會斷線，這是正常的
  

升級後：十分鐘的檢查

一、看修復（Repairs）

1. 設定 → 系統 → 修復

複製代碼

新版本如果有「不建議的設定」會列在這裡。

二、看日誌

1. 設定 → 系統 → 日誌

複製代碼

找紅色的錯誤，特別注意：

• 整合載入失敗
  
• 自訂元件的錯誤
  
• 模板錯誤
  

三、檢查裝置

• 設定 → 裝置與服務
  
• 有沒有整合變成「失敗」
  
• 有沒有大量實體變成 unavailable
  

四、實際測試

開幾個燈、看一下儀表板、觸發一個自動化。

五、清瀏覽器快取

前端有更新的話：

• Ctrl + Shift + R（Windows）
  
• Cmd + Shift + R（Mac）
  
• 手機 App 的話重開 App
  

很多「升級後介面壞掉」其實只是快取問題。



壞了怎麼辦

情況一：某個整合壞了

• 先看那個整合有沒有更新
  
• HACS 的東西：更新到最新版
  
• 官方整合：去 GitHub 看有沒有 issue
  
• 暫時停用那個整合
  

情況二：HA 起不來

用安全模式：

1. # SSH 進去
2. ha core stop
3. # 把可能有問題的自訂元件移走
4. mv /config/custom_components /config/custom_components.bak
5. ha core start

複製代碼

如果這樣就好了，就是自訂元件的問題。

情況三：完全掛掉

還原備份：

• 如果 HA 還能進：設定 → 系統 → 備份 → 還原
  
• 如果不能進：重灌 + 從備份還原
  
• 虛擬機的話還原快照最快
  

降級

HA 可以降回上一版：

1. ha core update --version 2026.8.3

複製代碼

注意：

• 降級之後資料庫可能不相容
  
• 比較安全的做法是還原備份
  
• 降級是最後手段
  

幾個實用的策略

一、不要升到 x.0

• 2026.9.0 通常會有一些問題
  
• 等 2026.9.2 或 .3 再升
  
• 大概等一兩週
  

二、看社群反應

• Reddit 的 r/homeassistant 每次更新都會有討論串
  
• HA 論壇也有
  
• 先看別人有沒有踩雷
  

三、不要落後太多

• 落後超過六個月會很難升
  
• 中間的 breaking changes 會累積
  
• 建議至少三個月升一次
  

四、附加元件和核心分開升

• 先升核心，確認沒事
  
• 再升附加元件
  
• 這樣出事的時候好查
  

五、Z2M 的升級要更小心

• 先備份 coordinator_backup.json、database.db、configuration.yaml
  
• 看 Z2M 的 changelog（2.0 那次改了很多）
  
• 升完看 migration log
  

一個升級的檢查清單

1. 升級前
2.   [ ] 看 Breaking Changes
3.   [ ] 建立備份（確認成功）
4.   [ ] ha core check
5.   [ ] 更新 HACS 的東西
6.   [ ] 挑一個有時間處理的時段
8. 升級後
9.   [ ] 看修復頁面
10.   [ ] 看日誌的錯誤
11.   [ ] 檢查整合有沒有失敗
12.   [ ] 檢查 unavailable 的實體
13.   [ ] 開幾個燈測試
14.   [ ] 清瀏覽器快取
15.   [ ] 觸發一個自動化測試
17. 一週後
18.   [ ] 確認沒有間歇性的問題
19.   [ ] 確認自動化都正常
20.   [ ] 確認能源資料沒有斷

複製代碼

把這個存成待辦清單的範本，每次升級跑一遍。

---

下一篇：系列的完整檢查表。