FritzBox路由器集成Google智能家居：GetGuestNetworkPassword功能异常

以下是针对该问题的排查和解决要点：

1. 修正挑战完成后的响应格式 #

用户输入PIN完成挑战后，EXECUTE响应必须明确标记挑战已完成，同时正确返回访客网络的核心信息：

{
  "requestId": "你的请求ID",
  "payload": {
    "commands": [
      {
        "ids": ["你的路由器设备ID"],
        "status": "SUCCESS",
        "challengeNeeded": false,
        "commandResults": [
          {
            "command": "action.devices.commands.GetGuestNetworkPassword",
            "state": {
              "guestNetworkPassword": "当前访客网络明文密码",
              "ssid": "当前访客网络名称"
            },
            "status": "SUCCESS"
          }
        ]
      }
    ]
  }
}

• 必须将challengeNeeded设为false，彻底结束挑战流程
• guestNetworkPassword和ssid必须是当前生效的真实值，不能为空或加密字符串

2. 检查SYNC响应的Trait配置 #

确认路由器设备在SYNC响应中正确声明GuestNetwork trait并开启密码获取支持：

{
  "traits": [
    "action.devices.traits.GuestNetwork",
    // 其他已配置的trait
  ],
  "attributes": {
    "guestNetwork": {
      "supportsEnableDisable": true,
      "supportsGetGuestNetworkPassword": true,
      "supportsSsid": true
    }
    // 其他设备属性
  }
}

• 必须包含supportsGetGuestNetworkPassword: true，否则Google Home不会触发密码获取流程

3. 规范FollowUpToken的使用逻辑 #

如果首次挑战响应返回了followUpToken，用户输入PIN后的EXECUTE请求会携带该token，此时你的响应需满足：

• 不再返回followUpToken或任何挑战相关字段
• 直接返回成功状态和密码信息，不能重复触发挑战流程

4. 深挖Cloud Console日志细节 #

除了CHALLENGE_NEEDED状态，重点排查以下日志内容：

• 响应格式是否合规（比如缺少必填字段、字段类型错误）
• 访客网络密码/SSID是否为空或无效
• 设备ID是否与请求中的ID匹配
• 后端PIN验证是否真的通过（避免验证逻辑存在隐性错误）

5. 确认访客网络状态 #

返回密码前，确保访客网络处于启用状态：

• 若访客网络已禁用，Google Home可能无法正常加载二维码
• 可先通过QUERY响应确认guestNetworkEnabled状态为true

内容的提问来源于stack exchange，提问作者Jerome