Matter设备通过Google Home App配网时卡在连接环节，信息显示异常

AI 小北

2026-7-4

可能的故障原因分析

设备核心属性未正确上报
桥接设备（类型ID 0xe）需通过Matter Basic集群向控制器同步NodeLabel、VendorName、ProductName等关键属性。如果你的设备在配网后未主动上报或响应控制器的属性读取请求，GHA无法获取自定义名称与厂商信息，只能显示默认的"bridge"。检查Espressif SDK中是否在设备初始化或配网完成阶段，正确设置并同步这些属性。
控制器与设备的属性同步阻塞
卡在"Connecting device to Google Home"环节，大概率是Nest Audio作为控制器在同步设备属性时出现异常。可以通过Espressif的调试工具抓取Matter通信包，确认控制器是否发送了Basic/Bridge集群的属性读取指令，设备是否返回了正确的响应。若设备无响应或响应格式错误，会导致流程停滞。
DCL元数据与Google控制台绑定异常
尽管VID、PID、设备类型ID一致，但需确认DCL中的产品元数据（名称、厂商信息）已完成Google侧的验证，且该产品已与你当前使用的开发者控制台项目绑定。另外检查DCL中设备类型是否准确标记为"Bridge"，元数据字段是否填写完整。
Espressif SDK桥接设备配置错误
桥接设备有特定的端点（Endpoint）与集群配置要求。若SDK中未正确启用Bridge集群功能，或端点结构不符合Matter规范，会导致GHA无法识别设备的完整信息，甚至卡在连接流程。核对SDK中桥接设备的配置项，确认端点数量、集群挂载是否符合官方文档要求。
配网完成事件未触发
Matter配网流程结束后，设备需向控制器发送CommissioningComplete事件，触发GHA完成后续的信息同步。如果你的设备未正确发送该事件，GHA会一直停留在连接状态。检查SDK中是否在配网成功后调用了对应的事件发送接口。
Nest Audio固件兼容性问题
旧版本的Nest Audio固件可能存在桥接设备的兼容性bug，导致属性同步失败或流程阻塞。先将Nest Audio更新至最新固件版本，再重新测试配网流程。