Alexa技能API测试遇unauthorized_client错误：凭证匹配问题排查

核心排查方向 #

• OAuth2授权模式是否匹配：Alexa Skill Management API（SMAPI）要求使用client_credentials模式获取访问令牌，确认Postman中选择的是该模式，而非authorization code等其他模式。
• 凭证权限范围是否正确：检查client ID对应的IAM角色是否拥有AlexaSkillsKitFullAccess权限，或对应操作的细分权限（比如创建intents需alexa::ask:skills:readwrite），权限不足会直接返回未授权错误。
• Postman请求配置细节：
  • 令牌端点是否正确：需使用对应区域的SMAPI令牌地址，比如北美区为https://api.amazon.com/auth/o2/token，欧盟区为https://api.eu.amazon.com/auth/o2/token，切勿填错。
  • 请求头是否合规：确保Content-Type设置为application/x-www-form-urlencoded，不能用JSON格式传参。
  • 参数拼写是否精准：grant_type必须设为client_credentials，client_id和client_secret要完整复制，避免带空格或多余字符。
• 账号与凭证有效性：确认Amazon开发者账号无限制状态，且client ID/secret是从正确的Alexa开发者控制台项目生成的，别混用AWS或其他Amazon服务的凭证。

快速验证方法 #

1. 用curl直接测试令牌获取，排除Postman配置问题：

curl -X POST "https://api.amazon.com/auth/o2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&scope=alexa::ask:skills:readwrite"

如果curl能成功获取令牌，说明Postman配置存在问题；若同样报错，则是凭证或权限层面的问题。

2. 重新生成凭证：登录Alexa开发者控制台，进入目标技能项目，在「权限」或「工具」板块重新生成client ID和secret，替换后再测试，避免旧凭证失效。

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