ESPHome 裝置出問題：照這個順序查（連不上、一直重開、記憶體）

charles

這篇的內容（16 段）

1. 燒錄後你會看到
2. 步驟 2：症狀「連不上 Wi-Fi」
3. 2-5 不要先去動發射功率
4. 步驟 3：症狀「一直重開機」
5. 步驟 4：症狀「記憶體不足」
6. 4-3 省記憶體，依效果排序
7. 一、關掉 `web_server`
8. 二、關掉不需要的東西
9. 三、減少字體 glyphs
10. 五、`framework: type: esp-idf`
11. 步驟 5：症狀「OTA 更新失敗」
12. 7-1 先燒一份最小設定
13. 7-2 一次加回一個元件
14. 7-3 記錄的方式
15. 放進每一台裝置的共用設定
16. 做一個總覽頁面

這篇給你一套固定的排查順序，和一份「每台裝置都該先裝上」的診斷設定。

排查順序的重點不是招式多，是每一步都有可讀的數字，你不用猜。



步驟 1：先裝診斷元件，不要等出事才接線

大多數人的除錯流程是「壞了 → 爬梯子拿下來 → 接 USB → 看日誌」。這很慢，而且間歇性的問題你接上去的時候通常好好的。

ESPHome 有一個內建的 `debug:` 元件，會把「為什麼重開」「記憶體剩多少」「主迴圈卡多久」變成 Home Assistant 裡的實體。先裝，之後所有排查都從這裡開始。

把下面這段加進你每一台裝置的 YAML（放在最外層，跟 `wifi:` 同一層）：

1. debug:
2.   update_interval: 60s
4. text_sensor:
5.   - platform: debug
6.     reset_reason:
7.       name: "上次重開原因"
8.       entity_category: diagnostic
9.     device:
10.       name: "裝置資訊"
11.       entity_category: diagnostic
12.   - platform: version
13.     name: "ESPHome 版本"
14.     entity_category: diagnostic
16. sensor:
17.   - platform: debug
18.     free:
19.       name: "可用記憶體"
20.       entity_category: diagnostic
21.     block:
22.       name: "最大連續區塊"
23.       entity_category: diagnostic
24.     fragmentation:
25.       name: "記憶體碎片化"
26.       entity_category: diagnostic
27.     loop_time:
28.       name: "主迴圈最長耗時"
29.       entity_category: diagnostic
30.   - platform: wifi_signal
31.     name: "Wi-Fi 訊號"
32.     update_interval: 300s
33.     entity_category: diagnostic
34.   - platform: uptime
35.     name: "運行時間"
36.     update_interval: 300s
37.     entity_category: diagnostic
39. binary_sensor:
40.   - platform: status
41.     name: "連線狀態"
42.     entity_category: diagnostic

複製代碼

⚠ 不要用舊教學那行 `lambda: 'return ESP.getFreeHeap();'`

`ESP` 這個物件是 Arduino 框架的東西。ESPHome 2026.1 起，ESP32 的預設框架已經是 esp-idf，這行會在編譯時直接失敗：

1. error: 'ESP' was not declared in this scope

複製代碼

而且就算你切回 arduino 能跑，「可用記憶體總量」也不是正確的指標（下面步驟 4 會說明為什麼）。

`entity_category: diagnostic` 是什麼：讓這些實體被歸到 HA 裝置頁面的「診斷」區，不會混在你平常要按的開關裡。

燒錄後你會看到

去 HA 的「設定 → 裝置與服務 → ESPHome」，點那台裝置，下方多出一個「診斷」區塊：

• 上次重開原因：典型值是 `Software reset CPU`（OTA 或你按的重開）、`Power on reset`（剛插電）、`Task watchdog`（程式卡住）、`Brownout reset`（電壓不足）
  
• 可用記憶體：ESP32 通常 120,000～200,000 位元組
  
• 最大連續區塊：健康的話會接近「可用記憶體」的一半以上
  
• 記憶體碎片化：健康是個位數到 20% 之間
  
• 主迴圈最長耗時：正常 16 毫秒以下
  

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

登入繼續閱讀使用 Google 登入