网站集成OAuth2管理Alexa列表遭遇未知Scope错误求助

核心问题说明 #

你用alexa::household:lists:read alexa::household:lists:write范围报错，是因为这些权限属于Alexa Skill专属权限体系，不能通过普通Login With Amazon（LWA）的OAuth请求直接申请，必须绑定你的Alexa Skill账号链接流程才能生效。

具体修复步骤 #

• 确认Alexa Skill配置（必须项）

  1. 打开你的Alexa Skill控制台，进入「权限」页面，开启「Lists Read」和「Lists Write」权限。
  2. 填写Skill的隐私政策URL（必填，否则权限申请会被拦截）。
  3. 进入「账号链接」页面，将你的网站回调URL（redirect_uri）添加到「重定向URI」列表中，确保和你授权请求里的地址完全一致。

• 构造正确的授权URL
  授权端点仍用https://www.amazon.com/ap/oa，但参数必须包含：

  client_id=你的Alexa Skill Client ID
  scope=alexa::household:lists:read alexa::household:lists:write
  response_type=code
  redirect_uri=你在Skill控制台配置的回调URL
  state=随机字符串（防CSRF用）
  

• 兑换访问令牌的正确流程
  用授权码兑换令牌时，请求https://api.amazon.com/auth/o2/token，参数如下：

  grant_type=authorization_code
  code=用户授权后返回的授权码
  redirect_uri=同一回调URL
  client_id=你的Alexa Skill Client ID
  client_secret=你的Alexa Skill Client Secret
  

关键注意事项 #

• 无需单独配置Login With Amazon应用：Alexa Skill的Client ID/Secret已经基于LWA体系，满足权限申请需求，不用额外开启联邦登录功能。
• 不要混用Skill权限和LWA标准范围：alexa::skills:account_linking这类范围仅用于Skill自身的账号绑定，无法获取列表管理权限，必须使用alexa::household:lists系列范围。

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