Google 找不到你的 HA 裝置：一步一步往下走的完整診斷流程

charles

這篇的內容（20 段）

1. 怎麼用這一篇
2. 這篇用的版本
3. 步驟 1：確認整合本身還活著
4. 1-A（Cloud）
5. 1-B（自行架設）
6. 3-2 三個限定 device_class 的 domain
7. 3-3 怎麼補 device_class
8. 步驟 4：確認它真的被曝露了
9. 4-A（Cloud）
10. 4-B（自行架設）
11. 步驟 6：檢查名稱衝突
12. 6-1 怎麼查
13. 6-2 怎麼改
14. 6-3 加別名
15. 6-4 指定區域
16. 步驟 7：讀日誌
17. 9-1 重新連結
18. 9-2 什麼時候該停手
19. 決策速查表
20. 做完之後養成的兩個習慣

接好了，但有些裝置就是不出現在 Google Home App 裡。這種問題最耗時間的地方不是修，是「不知道該從哪裡查」—— 每一個可能的原因看起來都一樣合理。這一篇把診斷排成一條有順序的路：每一步做一個動作、看一個結果、然後決定往下走還是停在這裡修。



怎麼用這一篇

照順序做，不要跳。 順序是依「排除成本」和「排除範圍」排的：前面幾步花十秒鐘，但每一步都能砍掉一大片可能性。跳著查的話，你會在第 7 步花兩小時，結果問題在第 3 步。

每一步的格式都是：做什麼 → 你會看到什麼 → 看到 A 往下走、看到 B 停在這裡修。

這篇用的版本

Home Assistant 穩定版 2026.9.3。

步驟 0：先確定你走的是哪一條路

這一步決定後面每一步的畫面長什麼樣，做錯的話你會一直在找不存在的選單。

到 設定 → 家庭助理雲端（Home Assistant Cloud）。

你會看到兩種畫面之一：

• A 路：頁面上有「Google Assistant」的區塊，寫著已連結，旁邊有管理按鈕 → 你走的是 Home Assistant Cloud
  
• B 路：頁面是登入畫面或訂閱廣告 → 你走的是自行架設。這時再去確認一件事：configuration.yaml 裡有沒有一段 google_assistant:。有的話就確定是 B 路
  

兩個都沒有 → 你根本沒接上 Google，不是「找不到裝置」而是「還沒開始」。這篇不適用，要先做完整合設定。

把你是 A 還是 B 記下來。 下面每一步都會分開寫。

步驟 1：確認整合本身還活著

1-A（Cloud）

在 設定 → 家庭助理雲端 的 Google Assistant 區塊。

你會看到「已連結」以及一個「管理實體」或「取消連結」之類的按鈕。

顯示「未連結」或「連線中斷」 → 停在這裡。先重新連結一次：Google Home App → 你的 Home Assistant 服務 → 取消連結 → 再重新連結。連結過程中跳出 Could not update the setting. Please check your connection. 的話，先做步驟 4 的「只曝露一個簡單裝置」再來重連。

1-B（自行架設）

到 開發者工具 → 動作 分頁，在搜尋框打 google_assistant。

你會看到至少一個動作：google_assistant.request_sync。

一個都搜不到 → 停在這裡。整合根本沒載入。到 設定 → 系統 → 日誌 → 右上角三個點 → 顯示完整紀錄 → 搜尋 google_assistant，多半會看到設定格式錯誤或找不到服務帳號 JSON 檔的訊息。

步驟 2：確認那個實體在 Home Assistant 這邊是好的

在懷疑 Google 之前，先確認東西真的存在。 這一步常常直接結案。

開發者工具 → 狀態 → 在實體欄位打那個裝置的名字（或前綴，例如 light.）。

你會看到一列：實體 ID、狀態、屬性。

• 狀態是 on / off / 一個數值 → 正常，往步驟 3 走。順便把那串實體 ID 抄下來，後面每一步都要用
  
• 狀態是 unavailable → 停在這裡。裝置離線中。Google 看不到離線的裝置是正常的，先把裝置救活
  
• 狀態是 unknown → 實體存在但沒有值。有些裝置要被操作過一次才有狀態，先手動點一下
  
• 完全搜不到 → 停在這裡。實體不存在，問題跟 Google 無關。到 設定 → 裝置與服務 → 實體，右上角的篩選把「顯示已停用的實體」打開，很可能它被停用了
  

⚠ 實體 ID 最近被改過的話，Google 那邊留的是舊的。 改過實體 ID 就一定要做步驟 5 的強制同步，而且有時候要先在 Google 那邊移除舊的才乾淨。

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

登入繼續閱讀使用 Google 登入