NextAuth.js谷歌OAuth认证失败，更换账号仍无法解决

• 检查Google Cloud控制台配置

  • 确认授权重定向URI完全匹配：http://localhost:3000/api/auth/callback/google，注意端口、协议（本地用http，生产用https），路径不能有任何拼写错误
  • 核对OAuth 2.0客户端ID和客户端密钥，确保和代码中GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET环境变量完全一致，不要带空格或多余字符
  • 确认项目已启用Google+ API（部分旧版NextAuth依赖该API，排查时可以先开启）
  • 检查OAuth客户端类型为「Web应用」，不要选桌面应用或其他类型

• 核对[...nextauth].ts配置

  • 确保Google Provider配置正确，示例：

    import NextAuth from "next-auth";
    import GoogleProvider from "next-auth/providers/google";
    
    export const authOptions = {
      providers: [
        GoogleProvider({
          clientId: process.env.GOOGLE_CLIENT_ID!,
          clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
        }),
      ],
      secret: process.env.NEXTAUTH_SECRET, // 必须设置，否则会出现签名验证错误
      callbacks: {
        async session({ session, token }) {
          // 自定义会话逻辑时，确保这里没有抛出错误或返回异常值
          return session;
        },
      },
    };
    
    export default NextAuth(authOptions);
    

  • 必须配置NEXTAUTH_SECRET环境变量，本地可以用openssl rand -hex 32生成随机字符串，生产环境要保持该值一致
  • 若有自定义signIn回调，确认没有返回false或抛出错误阻止登录：

    callbacks: {
      async signIn({ user, account, profile }) {
        // 自定义逻辑需确保最终返回true，或根据条件合理拦截
        return true;
      },
    }
    

• 检查Login.tsx组件

  • 确保登录触发逻辑正确，直接使用signIn方法而非手动拼接URL：

    import { signIn } from "next-auth/react";
    
    export default function Login() {
      return (
        <button onClick={() => signIn("google")}>
          用Google登录
        </button>
      );
    }
    

• 清除本地缓存干扰

  • 打开浏览器开发者工具，清除当前站点的所有Cookie和缓存，尤其是next-auth.session-token相关的Cookie
  • 尝试用无痕模式登录，排除本地缓存导致的异常

• 查看详细错误日志

  • 在[...nextauth].ts中开启调试模式：

    export const authOptions = {
      debug: true,
      // 其他配置项
    };
    

  • 启动项目后查看终端输出，日志会显示OAuth回调的具体错误原因（比如重定向URI不匹配、客户端无效等），根据日志精准定位问题

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