Next.js集成NextAuth Google认证时访问登录路由出错

1. 版本兼容性冲突 #

Next.js 15与NextAuth v4存在适配问题，NextAuth v4仅官方支持到Next.js 14，Next.js 15的App Router API有变更，导致路由处理逻辑不兼容。

解决方法二选一：

• 降级Next.js到14.x版本：修改package.json中的next依赖为"next": "^14.2.13"，执行npm install更新依赖
• 升级NextAuth到v5版本（适配Next.js 15）：
  1. 卸载旧版：npm uninstall next-auth
  2. 安装v5测试版：npm install next-auth@beta
  3. 调整auth.js配置（适配v5语法）：

     import NextAuth from "next-auth";
     import Google from "next-auth/providers/google";
     
     export const { handlers, auth } = NextAuth({
       providers: [
         Google({
           clientId: process.env.GOOGLE_CLIENT_ID,
           clientSecret: process.env.GOOGLE_CLIENT_SECRET,
           authorization: {
             params: {
               prompt: "consent",
               access_type: "offline"
             }
           }
         })
       ]
     });
     

2. 环境变量配置错误 #

确保项目根目录的.env.local文件中正确配置Google OAuth凭证，变量名无拼写错误：

GOOGLE_CLIENT_ID=你的谷歌客户端ID
GOOGLE_CLIENT_SECRET=你的谷歌客户端密钥

注意：变量值需完整复制，无多余空格；.env.local文件需放在项目根目录，Next.js会自动加载该文件。

3. 路由文件导入路径错误 #

检查auth.js的实际位置：

• 若auth.js在src/目录下，当前导入路径../../../../auth.js正确；
• 若auth.js在项目根目录（与src同级），需修改route.js的导入路径为：

  export { GET, POST } from "../../../../../auth.js";
  

建议将auth.js移至src/app/auth.js，简化导入路径为：export { GET, POST } from "../../auth.js";

4. 缺失Session策略配置（NextAuth v4 + App Router） #

Next.js 15的App Router环境下，NextAuth v4需显式指定session策略，否则会触发会话初始化错误。修改auth.js：

import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";

export const {
  handlers: { GET, POST },
} = NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET,
      authorization: {
        params: {
          prompt: "consent",
          access_type: "offline"
        }
      }
    })
  ],
  // 添加Session策略配置
  session: {
    strategy: "jwt"
  }
});

5. 冗余授权参数导致冲突 #

response_type: "code"是Google OAuth授权码流程的默认值，显式设置可能与NextAuth内部逻辑冲突，建议移除该参数：

authorization: {
  params: {
    prompt: "consent",
    access_type: "offline"
  }
}

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