NextJS/Auth0自定义回调处理器未按文档示例正常工作

一、解决afterCallback无法获取session.user的问题 #

你当前的核心问题是afterCallback中仅拿到returnTo而没有用户信息，这大概率是登录请求未携带必要的权限Scope导致的，按以下步骤修正：

1. 确保登录请求包含正确的Scope #

在调用handleLogin时，必须指定openid profile email这组Scope，因为email_verified字段需要email权限才能从Auth0获取：

export const GET = handleAuth({
  login: handleLogin({
    authorizationParams: {
      scope: 'openid profile email' // 必须配置此参数才能拿到用户邮箱及验证状态
    }
  }),
  callback: async (req, res) => {
    try {
      return await handleCallback(req, res, { afterCallback });
    } catch (error) {
      console.error(error);
    }
  }
})

2. 检查Auth0后台配置 #

• 确认应用的「Allowed Callback URLs」已包含你的回调地址（如http://localhost:3000/api/auth/callback）
• 确认Auth0用户配置中，email和email_verified字段已设置为可返回给应用的属性

3. 修正afterCallback跳转逻辑 #

nextjs-auth0的afterCallback会通过修改session.returnTo来控制最终跳转，无需手动调用res.redirect，正确逻辑如下：

const afterCallback = async (req, res, session) => {
  // 此时session.user应该能正常获取到
  if (session.user?.email_verified) {
    session.returnTo = '/dashboard';
  } else {
    session.returnTo = '/verify-email';
  }
  return session;
};

二、理清returnTo与callbackUrl的区别 #

• callbackUrl：这是Auth0服务器完成认证后，重定向回你应用的固定路由（默认是/api/auth/callback），必须在Auth0后台的「Allowed Callback URLs」中配置，属于Auth0与你应用之间的回调约定，一般不需要手动修改。
• returnTo：这是你的应用完成Auth0回调处理后，最终要跳转到的内部页面。比如用户登录前访问了/profile，returnTo就会自动设为/profile；你也可以在handleLogin中手动指定，或在afterCallback中动态修改（就像你实现邮箱验证跳转的场景）。如果不设置，默认会跳转到应用首页。

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