智能家居 · Matter 出现问题时

Matter 设备无法配对:按顺序排查

Matter 配对可能因多种原因失败,包括手机连接了错误网络、蓝牙关闭、设备未处于配对模式、没有 Thread 边界路由器,或网络阻止 IPv6 或多播。请按以下顺序检查。

核查于 2026 年 11 月 1 日。 iOS 18 上的 Apple 家庭、Google Home、Alexa App 和 Home Assistant,依据截至 2026 年 11 月的制造商帮助页面。

先检查手机和设备

  1. 将手机和平台 App 更新至最新版本。

  2. 如果设置应用要求,请在手机上开启蓝牙。许多设备使用 Bluetooth LE 接收网络信息;已在网络上的设备则可使用 IP。

  3. 将手机连接至家庭 Wi-Fi,而不是访客网络或移动数据。

  4. 对于 Wi-Fi Matter 设备,将手机连接至设备将使用的 2.4 GHz 网络。

  5. 打开设备电源,并将其放在手机和中枢附近。

  6. 开始前,按照制造商的说明将设备置于配对模式。

Amazon 的开发者指南指出,配对窗口很短且经常被错过。如果设置耗时较长,请让设备重新进入配对模式并重新开始。Amazon 要求设置时设备距离 Echo 不超过 9 米(30 英尺);Apple 建议将其移近路由器。

使用正确的设置码

  1. 扫描设备、包装盒或手册上的 Matter 二维码。

  2. 如果扫描失败,请输入印在二维码旁的数字配对码(11 位或 21 位)。

  3. 在 Home Assistant App 中,轻点更多选项…(iPhone)或不使用二维码设置(Android)。

  4. 在 Google Home 中,如果二维码无法扫描,请选择使用其他方式添加。

  5. 如果设备已在另一个 App 中,请在那里创建共享码并改用该码。

已经在另一个 App 中设置的设备不会将印刷的代码作为新设备代码接受。Apple 家庭 App 会在更多选项下提供该设备,Alexa 和 Google Home 也都有针对来自其他系统的设备的流程。

仅在其他检查后考虑重置

要共享已在另一个 Matter App 中的设备,请先使用该 App 的共享流程。Apple 表示,之前用于其他家庭的配件可能需要重置。恢复出厂设置可能删除现有配置并要求重新添加。

  1. 移除或重置设备前,请先尝试现有设备的共享流程。

  2. 如果制造商建议重置,请先保存原始设置码并了解后果。

  3. 按照制造商的重置和配对说明操作,然后重新添加设备。

对于 Thread 设备,检查边界路由器

Google Home 和 Home Assistant 对 Thread 设备要求使用 Thread 边界路由器。Apple 也支持某些具备 Thread 功能的 iPhone 直接配对。Apple 会显示“需要 Thread 边界路由器”或“需要 Thread 网络”;Google 要求使用 Thread 边界路由器。

  1. 检查是否有边界路由器:各制造商的列表请参阅Thread 页面。

  2. 重启边界路由器,例如 HomePod mini、Nest Hub 或 Echo。

  3. 如果 Apple TV 作为边界路由器并使用以太网,Apple 建议改为连接 Wi-Fi。

  4. 检查边界路由器是否与手机连接同一 Wi-Fi 网络。

  5. 添加设备时站在边界路由器和设备附近。

  6. 在 Android 上,Google 建议仅在所有其他步骤都失败后才清除已存储的 Thread 凭据。

检查 Matter 依赖的路由器设置

Home Assistant 将本地 IPv6 和多播 DNS 列为配网或发现失败时需要检查的网络要求。

  • IPv6:Google 表示家庭 Wi-Fi 必须开启 IPv6,否则设置可能看似成功但之后无法控制。互联网服务商无需提供 IPv6。
  • 多播和 mDNS:关闭路由器或接入点中过滤或“优化”多播的功能。Home Assistant 还提醒注意异常的 IGMP 侦听和过滤 mDNS 的网状系统。
  • 同一网络或 VLAN:让手机、中枢和 Wi-Fi Matter 设备位于同一网络。Home Assistant 要求 Wi-Fi 设备和边界路由器位于它自己的 VLAN。
  • 客户端隔离和访客网络:隔离可能阻止同一 Wi-Fi 上的设备相互连接并干扰发现。
  • VPN 和安全 App:Apple 要求检查它们是否造成网络问题。

各平台记录的错误

  • Apple 家庭,“无法添加到家庭”:开启配件,将其移近路由器,拔下并重新接通中枢和网桥,然后重置配件。
  • Apple 家庭,“网络不兼容”:加入 2.4 GHz 网络;部分配件无法使用 5 GHz。
  • Apple 家庭,“不受支持”:在制造商的 App 中更新配件固件。
  • Google Home,设置卡住:重启设备、清除 Google Home App 缓存、重启手机并重试。先检查 Google Home 中是否已设置 Matter 中枢。
  • Alexa:对于 Thread 设备,检查支持 Thread 的 Echo 或 eero 是否在线。如果没有,Amazon 建议先用另一个支持 Thread 的助手添加设备,然后共享给 Alexa。
  • Home Assistant:在 Android 上,将 Companion App 的位置权限设置为始终允许。Thread 配对需要连接到 Home Assistant 网络的边界路由器。

常见问题

为什么 Matter 配对看似成功,但设备始终没有响应?

Google 表示,如果 Wi-Fi 未启用 IPv6,设置可能看似成功,但之后无法控制。Home Assistant 也指向类似问题:检查 VLAN、多播过滤和边界路由器。

要将设备添加到第二个 App,必须重置吗?

不需要。在第一个 App 中创建共享码,并在第二个 App 中输入;Home Assistant 指出无需按按钮。Apple 表示,之前用于其他家庭的配件可能需要重置。

参考资料

核查日期:2026 年 11 月 1 日。

从 Mac 查看家庭网络

Kilobat 是一款 Mac 菜单栏 App,附带供 AI 智能体使用的 CLI 和 MCP 服务器。它列出 Wi-Fi 上的设备并在新设备加入时通知你,记录路由器和互联网的健康历史,扫描附近信道,并显示 Mac 上哪个 App 正在使用网络。阅读文档。

下载 Mac 版 ↓
brew install seifip/kilobat/kilobat