智能家居 · Matter 出现问题时
Matter 设备无法配对:按顺序排查
Matter 配对可能因多种原因失败,包括手机连接了错误网络、蓝牙关闭、设备未处于配对模式、没有 Thread 边界路由器,或网络阻止 IPv6 或多播。请按以下顺序检查。
先检查手机和设备
将手机和平台 App 更新至最新版本。
如果设置应用要求,请在手机上开启蓝牙。许多设备使用 Bluetooth LE 接收网络信息;已在网络上的设备则可使用 IP。
将手机连接至家庭 Wi-Fi,而不是访客网络或移动数据。
对于 Wi-Fi Matter 设备,将手机连接至设备将使用的 2.4 GHz 网络。
打开设备电源,并将其放在手机和中枢附近。
开始前,按照制造商的说明将设备置于配对模式。
Amazon 的开发者指南指出,配对窗口很短且经常被错过。如果设置耗时较长,请让设备重新进入配对模式并重新开始。Amazon 要求设置时设备距离 Echo 不超过 9 米(30 英尺);Apple 建议将其移近路由器。
使用正确的设置码
扫描设备、包装盒或手册上的 Matter 二维码。
如果扫描失败,请输入印在二维码旁的数字配对码(11 位或 21 位)。
在 Home Assistant App 中,轻点更多选项…(iPhone)或不使用二维码设置(Android)。
在 Google Home 中,如果二维码无法扫描,请选择使用其他方式添加。
如果设备已在另一个 App 中,请在那里创建共享码并改用该码。
已经在另一个 App 中设置的设备不会将印刷的代码作为新设备代码接受。Apple 家庭 App 会在更多选项下提供该设备,Alexa 和 Google Home 也都有针对来自其他系统的设备的流程。
仅在其他检查后考虑重置
要共享已在另一个 Matter App 中的设备,请先使用该 App 的共享流程。Apple 表示,之前用于其他家庭的配件可能需要重置。恢复出厂设置可能删除现有配置并要求重新添加。
移除或重置设备前,请先尝试现有设备的共享流程。
如果制造商建议重置,请先保存原始设置码并了解后果。
按照制造商的重置和配对说明操作,然后重新添加设备。
对于 Thread 设备,检查边界路由器
Google Home 和 Home Assistant 对 Thread 设备要求使用 Thread 边界路由器。Apple 也支持某些具备 Thread 功能的 iPhone 直接配对。Apple 会显示“需要 Thread 边界路由器”或“需要 Thread 网络”;Google 要求使用 Thread 边界路由器。
检查是否有边界路由器:各制造商的列表请参阅Thread 页面。
重启边界路由器,例如 HomePod mini、Nest Hub 或 Echo。
如果 Apple TV 作为边界路由器并使用以太网,Apple 建议改为连接 Wi-Fi。
检查边界路由器是否与手机连接同一 Wi-Fi 网络。
添加设备时站在边界路由器和设备附近。
在 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 表示,之前用于其他家庭的配件可能需要重置。
参考资料
- Apple 支持:如果无法将智能家居配件添加到家庭 App
- Apple 支持:如果看到“需要 Thread 边界路由器”提醒
- Google Home 帮助:设置、管理和控制支持 Matter 的设备
- Google Home 开发者:Matter 故障排除
- Amazon 帮助:将 Matter 智能家居设备连接至 Alexa
- Amazon Alexa 开发者文档:Matter 设备配网最佳实践
- Home Assistant:Matter 集成
- OpenThread:mDNS 发现
核查日期:2026 年 11 月 1 日。
从 Mac 查看家庭网络
Kilobat 是一款 Mac 菜单栏 App,附带供 AI 智能体使用的 CLI 和 MCP 服务器。它列出 Wi-Fi 上的设备并在新设备加入时通知你,记录路由器和互联网的健康历史,扫描附近信道,并显示 Mac 上哪个 App 正在使用网络。阅读文档。
brew install seifip/kilobat/kilobat