Next.js中使用next-auth实现Google OAuth认证失败排查

问题根源分析 #

HTTP 405错误表示请求方法不被允许，结合你的配置，主要存在以下几个问题：

• 敏感环境变量错误使用NEXT_PUBLIC_前缀，导致密钥暴露风险且服务器端读取逻辑异常
• Next.js 13+ App Router模式下，路由文件未按要求导出GET/POST方法，无法正确处理认证请求
• 可能遗漏Google开发者控制台的回调URL配置，导致认证流程中断

修正方案 #

1. 修复环境变量配置 #

在项目根目录的.env.local文件中，移除NEXT_PUBLIC_前缀（clientSecret是敏感信息，不能暴露到前端）：

GOOGLE_CLIENT_ID=你的Google客户端ID
GOOGLE_CLIENT_SECRET=你的Google客户端密钥

2. 修正API路由文件 #

修改app/(index)/api/auth/[...nextauth]/route.ts，按照App Router要求显式导出请求方法：

import NextAuth, { Account, NextAuthOptions, Profile } from "next-auth";
import GoogleProvider from "next-auth/providers/google";

export const authOptions: NextAuthOptions = {
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID as string,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,
      authorization: {
        params: {
          prompt: "consent",
          access_type: "offline",
          response_type: "code"
        }
      },
    }),
  ],
  callbacks: {
    async signIn({ account, profile }: { account: Account | null; profile?: Profile | undefined; }) {
      const isAccount = account && profile;
      if (isAccount && account.provider === "google") {
        // return profile.email_verified && profile.email.endsWith("@example.com");
        return true;
      }
      return true; // 其他提供商可单独处理
    }
  }
}

// App Router必须显式导出GET和POST方法
const handler = NextAuth(authOptions);
export { handler as GET, handler as POST };

3. 补全Google控制台回调URL #

在Google开发者控制台的OAuth 2.0客户端凭据页面，添加以下回调URL：

http://localhost:3000/api/auth/callback/google

生产环境需替换为你的正式域名，确保使用HTTPS协议

4. 优化登录组件（可选） #

在登录组件中明确指定Google提供商，避免默认逻辑的潜在问题：

import { signIn } from "next-auth/react";

export default function LoginPage() {
  return (
    <div>
      <button
        onClick={() => {
          signIn("google"); // 指定使用Google认证
        }}
      >
        Sign in with Google
      </button>
    </div>
  );
}

验证步骤 #

1. 重启Next.js开发服务器（环境变量修改后必须重启）
2. 点击登录按钮，正常情况下会跳转至Google授权页面
3. 完成授权后将自动返回应用，认证流程生效

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