Next.js TypeScript应用获取Alexa Lists管理权限的OAuth2问题

1. 权限范围报错的原因与修复 #

你遇到的unknown scope错误，核心原因是alexa::household:lists:read/write属于Alexa Skills专属权限，不能直接通过Login With Amazon（LWA）的标准OAuth2端点https://www.amazon.com/ap/oa发起请求。这个端点仅支持LWA通用权限（如profile:user_id、postal_code）或技能关联的alexa::skills:account_linking，无法识别Alexa Lists的特定权限。

正确操作步骤：

• 确认你的Alexa技能已在开发者后台开启账户链接功能，并将alexa::household:lists:read和alexa::household:lists:write添加到技能的权限列表中，且状态为“已启用”。
• 授权请求必须关联到你的Alexa技能：确保请求中的client_id是技能的Client ID，同时在技能的账户链接配置中，将这些列表权限添加到授权范围（scope）中。此时发起的授权请求才能被亚马逊识别并授予对应权限。

2. Client ID的正确性确认 #

你使用Alexa技能的Client ID是完全正确的。Alexa Lists权限仅对关联的Alexa技能开放，LWA的Client ID无法获取这类权限，无需更换。

3. 是否需要配置Login With Amazon？ #

不需要。你不需要启用LWA的联邦登录功能，因为你的需求是获取Alexa技能的特定列表权限，而非让用户通过亚马逊账号登录你的应用。专注于Alexa技能的账户链接流程即可满足需求。

4. Next.js/TypeScript环境下的简化方案 #

• Next-auth自定义Provider：Next-auth支持自定义OAuth2 Provider，你可以直接配置适配Alexa账户链接流程的Provider，无需额外依赖。示例核心配置：

  import NextAuth from "next-auth";
  import type { OAuthConfig } from "next-auth/providers/oauth";
  
  const AlexaProvider: OAuthConfig<any> = {
    id: "alexa",
    name: "Alexa",
    type: "oauth",
    authorization: {
      url: "https://www.amazon.com/ap/oa",
      params: {
        client_id: process.env.ALEXA_SKILL_CLIENT_ID!,
        redirect_uri: process.env.ALEXA_REDIRECT_URI!,
        response_type: "code",
        scope: "alexa::household:lists:read alexa::household:lists:write",
      },
    },
    token: {
      url: "https://api.amazon.com/auth/o2/token",
      async request({ client, params, checks, provider }) {
        const tokens = await client.oauth2.getToken(params);
        return { tokens };
      },
    },
    clientId: process.env.ALEXA_SKILL_CLIENT_ID,
    clientSecret: process.env.ALEXA_SKILL_CLIENT_SECRET,
    profile: () => ({ id: "alexa-user-id" }), // 根据实际返回的用户信息调整
  };
  
  export default NextAuth({
    providers: [AlexaProvider],
  });
  

• simple-oauth2：如果不想依赖Next-auth，这个轻量级库可以简化OAuth2授权码交换、令牌刷新等流程，完全适配TypeScript环境，可直接在Next.js的API路由或服务器组件中使用。

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