Google 找不到 HA 的裝置？六種原因與排查順序

charles

「我在 HA 明明有這個燈，但 Google Home App 裡看不到。」

這是 Google 整合最常見的問題。照這個順序查。



第一步：確認曝露設定

設定 → 語音助理 → Google Assistant → 曝露的實體

• 那個實體在清單上嗎？
  
• 開關是開的嗎？
  

HA 預設不會曝露所有東西。
新增的實體可能沒有自動加入（取決於你的「曝露新實體」設定）。

批次處理：那個頁面上方可以按網域篩選，然後多選。

第二步：確認 Google 支不支援那個類型

這是最多人卡住的地方。

Google 智慧家庭的裝置類型比 HomeKit 還少。

支援良好：

• light（燈）—— 開關、亮度、色溫、顏色
  
• switch（開關）
  
• climate（冷暖氣）—— 溫度、模式
  
• cover（窗簾、車庫門）
  
• lock（門鎖）—— 但預設需要語音 PIN 才能解鎖
  
• fan（風扇）
  
• media_player（部分功能）
  
• scene（場景）
  
• script（會變成一個場景）
  
• vacuum（掃地機器人）
  

支援有限：

• sensor —— 只有溫度和濕度會被接受，而且只能用問的
    （「客廳幾度」），不會出現在 App 的主畫面
  
• binary_sensor —— 只有少數類型（門窗、移動、煙霧）
  

完全不支援：

• input_number、input_text、input_datetime
  
• counter、timer
  
• 功率、電壓、用電量等數值感測器
  
• automation（不能直接曝露，要包成 script 或 input_boolean）
  
• person、device_tracker
  

解法：不支援的類型包成支援的類型。

1. # input_boolean 包成 switch
2. switch:
3.   - platform: template
4.     switches:
5.       vacation_mode:
6.         friendly_name: 度假模式
7.         value_template: "{{ is_state('input_boolean.vacation','on') }}"
8.         turn_on:
9.           action: input_boolean.turn_on
10.           target: {entity_id: input_boolean.vacation}
11.         turn_off:
12.           action: input_boolean.turn_off
13.           target: {entity_id: input_boolean.vacation}

複製代碼

第三步：手動同步

HA 改了東西之後，Google 那邊不會立刻知道。

三種同步方式：

• 對 Google 說「同步我的裝置」
  
• Google Home App → 下拉重新整理
  
• 在 HA 呼叫 google_assistant.request_sync
  

自動同步（推薦設一個）：

1. alias: HA 重啟後同步 Google
2. triggers:
3.   - trigger: homeassistant
4.     event: start
5. actions:
6.   - delay: "00:05:00"      # 等整合都載入完
7.   - action: google_assistant.request_sync
8. mode: single

複製代碼

注意：request_sync 有頻率限制，不要寫成每分鐘同步。

第四步：檢查名稱

Google 對名稱很敏感。

問題名稱：

• 重複的名稱 —— 兩個裝置都叫「燈」，Google 會困惑
  
• 太長 —— 「客廳天花板主要照明燈具」很難唸
  
• 包含數字或英文 —— 「Light 1」中文語音會唸不出來
  
• 特殊符號、emoji —— 可能導致同步失敗
  

好的命名：

• 簡短、好唸：「客廳燈」「餐廳燈」「書房燈」
  
• 不要加房間前綴又加房間標籤（會變成「客廳的客廳燈」）
  

小技巧：在 Google Home App 裡可以另外設暱稱，
不用改 HA 的名稱。一個裝置可以有多個暱稱。

第五步：檢查房間指派

Google Home App 裡每個裝置要指派房間。

沒有指派房間的裝置：

• 不會出現在房間視圖
  
• 「關掉客廳的燈」不會包含它
  

HA 的區域不會自動變成 Google 的房間，要在 Google Home App 裡手動設。

第六步：檢查帳號與整合狀態

• HA 的 Google Assistant 整合有沒有連結
  
• 用的是同一個 Google 帳號嗎？
  
• Nabu Casa 訂閱還有效嗎？
  
• 自己架的 Google Cloud 專案的話，OAuth 憑證有沒有過期
  

進階除錯

看 HA 的日誌：

1. logger:
2.   default: warning
3.   logs:
4.     homeassistant.components.google_assistant: debug

複製代碼

重啟後看日誌，SYNC 請求會列出送給 Google 的所有裝置。

不在那份清單上的 = 根本沒被送出去。

用 Google 的測試工具：

Google Home App → 設定 → 你的 HA 整合 →
可以看到「已連結的裝置」數量。

跟 HA 曝露的數量比對，數字對不上就是有東西被過濾掉了。

幾個特殊狀況

狀況一：燈的顏色 / 色溫不能調

• HA 的燈要有 supported_color_modes 屬性
  
• 在開發者工具 → 狀態，看那個燈有沒有 color_temp_kelvin 或 hs_color
  
• 沒有的話代表那盞燈本來就不支援
  

狀況二：門鎖不能用語音開

這是 Google 的安全設計：

• 預設可以用語音上鎖，但不能用語音解鎖
  
• 要解鎖的話要在 Google Home App 裡設定語音比對或 PIN
  
• 有些地區完全不允許語音解鎖
  

我覺得這個限制是對的，不要試著繞過它。

狀況三：場景和腳本觸發了但沒反應

• HA 的 script 曝露給 Google 之後會變成「場景」
  
• 語音是「啟動 XXX」不是「打開 XXX」
  
• script 的 mode 如果是 single 而且還在執行，會被忽略
  

狀況四：裝置顯示「離線」

• HA 那邊那個實體是不是 unavailable
  
• Nabu Casa 的連線狀態（設定 → Home Assistant Cloud）
  
• HA 主機的網路
  

狀況五：控制有延遲（三五秒）

這是走雲端的必然：

1. 你說話 → Google 雲端 → Nabu Casa → 你家的 HA → 裝置

複製代碼

要解決只能走本地：

• 用 Matter 把裝置送給 Google（本地控制）
  
• 或者直接用 HA 的 Assist（但那是不同的語音助理）
  

一個實用的檢查清單

裝置沒出現的時候，照順序：

• HA 裡那個實體正常嗎（不是 unavailable）
  
• 有曝露嗎
  
• Google 支援那個類型嗎
  
• 同步過了嗎
  
• 名稱有沒有問題
  
• 看日誌的 SYNC 清單
  

九成的問題在前三項。

---

最後一個建議：不要把所有東西都曝露給 Google。

曝露太多的話：

• 語音辨識容易選錯裝置
  
• Google Home App 變得很亂
  
• 同步變慢
  

我自己只曝露 20 幾個 —— 就是家人真的會用語音控制的那些。