NextAuth Google Provider整合Firestore安全规则及适配器报错求助

核心问题分析 #

你遇到的是NextAuth Firestore Adapter与Google Provider认证冲突的问题，本质是Adapter配置时的权限或初始化逻辑错误，导致认证流程中断，而非Adapter本身的兼容性问题。

分步解决步骤 #

1. 修正Firestore Adapter配置与Session策略 #

使用Firestore Adapter时，必须将Session策略从jwt切换为database，同时保证Adapter初始化逻辑符合NextAuth v5（适配Next.js14）的要求，示例配置如下：

import { FirestoreAdapter } from "@auth/firebase-adapter";
import GoogleProvider from "next-auth/providers/google";
import { initializeApp, getApps, getApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";
import { AuthOptions } from "next-auth";

// 从环境变量加载service-account配置
const firebaseServiceAccount = JSON.parse(process.env.FIREBASE_SERVICE_ACCOUNT as string);

// 避免重复初始化Firebase App
const firebaseApp = getApps().length === 0 ? initializeApp(firebaseServiceAccount) : getApp();
const firestoreDB = getFirestore(firebaseApp);

export const authOptions: AuthOptions = {
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID as string,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,
    }),
  ],
  adapter: FirestoreAdapter(firestoreDB),
  session: { strategy: "database" }, // 必须设置为database策略
  // 暂时移除自定义signIn回调，先保证Adapter基础功能正常
};

2. 验证Service Account权限 #

确保你的service-account.json对应的账号拥有足够的Firestore权限：

• 登录Firebase控制台，进入IAM与管理员页面
• 找到该服务账号，为其分配Editor角色（至少包含datastore.user权限，允许读写Firestore文档）

3. 清理旧数据并重新测试 #

• 删除Firestore中之前自定义创建的users集合
• 清除浏览器缓存及本地存储的NextAuth会话数据
• 重启Next.js开发服务器，重新尝试Google登录

4. 配置适配Adapter的安全规则 #

待Adapter自动生成users、sessions、accounts集合后，更新Firebase安全规则：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 允许认证用户访问自身的用户数据
    match /users/{userId} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
    // 允许NextAuth Adapter读写会话与账号数据
    match /sessions/{sessionId} {
      allow read, write: if request.auth != null;
    }
    match /accounts/{accountId} {
      allow read, write: if request.auth != null;
    }
  }
}

5. 开启调试定位剩余问题 #

如果仍有报错，在authOptions中开启调试并添加日志：

export const authOptions: AuthOptions = {
  // ...其他配置
  debug: true, // 开启NextAuth调试模式
  callbacks: {
    async signIn({ user, account }) {
      console.log("SignIn 回调数据:", { user, account });
      return true;
    },
    async jwt({ token, user, account }) {
      console.log("JWT 回调数据:", { token, user, account });
      return token;
    },
  },
};

通过终端日志判断是Google Provider回调错误，还是Firestore Adapter的写入权限问题。

关键注意事项 #

• 确保安装的是适配NextAuth v5的@auth/firebase-adapter，而非旧版next-auth/adapters/firebase
• 待Adapter正常工作后，再通过adapter.createUser钩子自定义用户模型，不要同时使用自定义signIn回调与Adapter的自动创建逻辑

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