如何使用Next-auth适配器在Firestore存储用户信息？含v4+及v5适配问题

一、避开v5 Firebase适配器版本冲突的替代方案 #

由于v5 beta版Firebase适配器与现有最新Firebase依赖存在冲突，且会抛出「r is not function」错误，推荐手动实现适配逻辑，基于Next-auth的自定义适配器接口对接Firestore，步骤如下：

• 安装必要依赖：确保服务端可用firebase-admin，保持现有next-auth版本不变
• 初始化Firebase Admin：在Next.js服务端文件（如app/api/auth/[...nextauth]/route.ts）中用服务账号密钥初始化Admin SDK：

import { initializeApp, cert, getApps } from "firebase-admin/app";
import { getFirestore } from "firebase-admin/firestore";

if (!getApps().length) {
  initializeApp({
    credential: cert(JSON.parse(process.env.FIREBASE_ADMIN_KEY || ""))
  });
}
const db = getFirestore();

• 实现自定义适配器：按照Next-auth适配器规范，实现createUser、getUserByEmail等核心方法，直接操作Firestore：

import type { Adapter } from "next-auth/adapters";

export const firestoreAdapter = (db: FirebaseFirestore.Firestore): Adapter => ({
  async createUser(user) {
    const userRef = db.collection("users").doc();
    await userRef.set({
      ...user,
      createdAt: new Date(),
      updatedAt: new Date()
    });
    return { id: userRef.id, ...user };
  },
  async getUserByEmail(email) {
    const snapshot = await db.collection("users").where("email", "==", email).get();
    if (snapshot.empty) return null;
    const doc = snapshot.docs[0];
    return { id: doc.id, ...doc.data() } as any;
  },
  // 按需实现getUser、updateUser等其他必要方法
});

• 在Next-auth配置中使用自定义适配器：

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

export const { handlers, auth, signIn, signOut } = NextAuth({
  providers: [GoogleProvider({
    clientId: process.env.GOOGLE_CLIENT_ID!,
    clientSecret: process.env.GOOGLE_CLIENT_SECRET!
  })],
  adapter: firestoreAdapter(db),
});

二、关于Firebase客户端SDK在服务端运行的疑问 #

官方v5适配器能让客户端SDK在Next.js服务端运行，核心是做了这些适配：

• 自动环境检测：适配器会判断当前运行环境，服务端场景下自动切换为Firebase Admin SDK逻辑，而非纯客户端SDK
• 服务端初始化兼容：利用Next.js的服务端初始化机制，避免客户端SDK在服务端的初始化错误
• 统一接口封装：将客户端与服务端的SDK操作封装为符合Next-auth规范的统一接口，上层无需关心底层SDK差异

三、官方Firebase适配器文档（中文翻译） #

Firebase适配器 #

Auth.js提供官方Firebase适配器，用于将用户会话、账户数据存储至Firestore。

安装

安装所需依赖：

npm install next-auth @auth/firebase-adapter firebase

配置

1. 在Firebase控制台创建项目，启用Firestore数据库
2. 获取Firebase配置信息，添加至环境变量
3. 在Next-auth配置中引入并使用适配器：

import { FirebaseAdapter } from "@auth/firebase-adapter";
import { initializeApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";

const firebaseApp = initializeApp({
  // 填入你的Firebase配置
});
const db = getFirestore(firebaseApp);

export default NextAuth({
  adapter: FirebaseAdapter(db),
  providers: [...],
});

注意事项

• 确保Firestore安全规则配置正确，允许Auth.js服务端操作数据
• 若使用服务端渲染或API路由，建议配合Firebase Admin SDK使用，提升性能与权限控制

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