Alexa智能家居设备持续显示‘出现问题’故障排查求助

核心排查方向（Lambda能返回但Alexa报错） #

Alexa对响应格式的校验极其严格，哪怕是大小写、字段拼写这类小问题都会触发错误，重点查以下几点：

1. 状态响应的格式合规性 #

• 电源状态值必须严格大写：powerState的取值只能是"ON"或"OFF"，小写的"on"/"off"会被判定为无效，直接导致设备显示OFF并报错。
• correlationToken必须完全匹配：这个字段是Alexa用来关联请求和响应的唯一标识，Lambda返回的响应里必须和Alexa请求中的correlationToken完全一致，差一个字符都不行。
• endpointId要和发现响应一致：状态响应里的设备ID必须和Discover.Response里返回的设备ID完全对应，否则Alexa找不到对应的设备，状态无法更新。

2. 发现响应的设备配置错误 #

• 必须声明可获取状态的能力：每个设备的capabilities里，PowerController接口需要设置retrievable: true，否则Alexa会认为该设备无法获取状态，直接显示灰色OFF。
• 设备分类要匹配实际类型：displayCategories必须选对（比如灯用LIGHT，插座用SMARTPLUG），分类错误会导致Alexa无法正确渲染设备状态。

3. 响应JSON的隐性语法错误 #

• 用JSON校验工具检查Lambda返回的响应，哪怕是遗漏逗号、引号不闭合这类小问题，都会被Alexa拒收，表现为设备状态异常。
• 检查context字段的命名空间和属性名：namespace必须是Alexa.PowerController，name必须是powerState，拼写错误直接导致状态不生效。

实操排查步骤 #

1. 开启Lambda的CloudWatch日志，捕获完整的Alexa请求和Lambda响应内容。
2. 对比Alexa官方的响应规范，逐一核对每个字段的格式、大小写、取值范围。
3. 手动构造一个符合规范的测试状态响应（比如固定返回powerState: "ON"），发送给Alexa，看设备状态是否正常，以此区分是服务器数据问题还是格式问题。

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