Next.js中Auth0登出URL出现404错误与SSO登出问题

核心原因 #

1. 版本兼容性冲突：@auth0/nextjs-auth0 1.9.1是针对Next.js Pages Router设计的旧版本，不支持Next.js 13+引入的App Router架构，导致登出流程无法正确生成Auth0官方的登出端点（https://<your-auth0-domain>/v2/logout），反而错误重定向到本地不存在的/v2/logout路径，触发404。
2. SDK参数处理异常：旧版本SDK会错误地将client_id附加到returnTo参数中，导致最终的returnTo URL与Auth0控制台配置的Allowed Logout URLs不匹配（配置的是http://localhost:3000/login，但实际传递的是带client_id的版本）。

修复步骤 #

1. 升级Auth0 SDK到兼容版本 #

@auth0/nextjs-auth0 v3.x及以上版本才支持Next.js 13+的App Router，执行升级命令：

npm install @auth0/nextjs-auth0@latest

2. 适配Next.js 14的App Router重构登出代码 #

如果使用App Router，将登出逻辑放在app/api/auth/logout/route.js中：

import { auth } from '@/auth';

export async function GET(request) {
  return auth(request).logout({
    returnTo: 'http://localhost:3000/login'
  });
}

注：如果仍在使用Pages Router，保留pages/api/auth/logout.js的写法即可，但需确保SDK版本已升级。

3. 校验Auth0控制台与.env配置 #

• Allowed Logout URLs：确保仅添加http://localhost:3000/login，不要包含任何额外参数（如client_id）。
• 环境变量配置：确认.env.local中的Auth0参数正确无误：

AUTH0_SECRET=your-generated-secret
AUTH0_BASE_URL=http://localhost:3000
AUTH0_ISSUER_BASE_URL=https://<your-auth0-domain>.auth0.com
AUTH0_CLIENT_ID=your-client-id
AUTH0_CLIENT_SECRET=your-client-secret

AUTH0_SECRET可以通过openssl rand -hex 32命令生成。

4. 验证登出流程 #

升级并配置完成后，触发登出会先跳转到Auth0的/v2/logout端点完成会话清理，再自动重定向到http://localhost:3000/login，不会再出现404错误。

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