Clerk登录集成Firebase：Auth生成用户但Firestore未创建文档

核心问题原因 #

通过Clerk自定义Token登录Firebase时，functions.auth.user().onCreate触发器虽被调用，但因处理UserRecord对象的方式不当，导致无法在Firestore中创建用户文档。手动创建用户时触发器正常，说明触发器本身逻辑无问题，问题出在Clerk生成的用户对象序列化过程中。

Clerk官方回复翻译 #

Clerk官方支持回复："我们不提供直接集成。你需要从用户信息中提取所需内容来填充用户表。"

具体修复步骤 #

1. 优化Firebase函数的数据处理逻辑 #

原代码中JSON.parse(JSON.stringify(user))的方式会丢失UserRecord对象的部分属性或导致序列化失败，改为手动提取所需字段：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";

admin.initializeApp();
const db = admin.firestore();

export const newUser = functions.auth.user().onCreate(async (user) => {
  // 提取UserRecord中的关键字段，转为普通可序列化对象
  const userData = {
    uid: user.uid,
    email: user.email,
    displayName: user.displayName,
    photoURL: user.photoURL,
    emailVerified: user.emailVerified,
    providerData: user.providerData.map(provider => ({
      providerId: provider.providerId,
      uid: provider.uid,
      email: provider.email,
      displayName: provider.displayName,
      photoURL: provider.photoURL
    })),
    createdAt: user.metadata.createdAt,
    lastSignInTime: user.metadata.lastSignInTime
  };

  try {
    await db.collection("user").doc(user.uid).create(userData);
    console.log(`用户文档创建成功: ${user.uid}`);
  } catch (error) {
    console.error(`创建用户文档失败: ${error}`);
  }
});

2. 升级到Firebase Functions v2版本 #

若需升级到v2版本，修改代码如下：

import { onUserCreated } from "firebase-functions/v2/auth";
import * as admin from "firebase-admin";

admin.initializeApp();
const db = admin.firestore();

export const newUser = onUserCreated(async (event) => {
  const user = event.data;
  if (!user) {
    console.error("未获取到用户数据");
    return;
  }

  const userData = {
    uid: user.uid,
    email: user.email,
    displayName: user.displayName,
    photoURL: user.photoURL,
    emailVerified: user.emailVerified,
    providerData: user.providerData.map(provider => ({
      providerId: provider.providerId,
      uid: provider.uid,
      email: provider.email,
      displayName: provider.displayName,
      photoURL: provider.photoURL
    })),
    createdAt: user.metadata.createdAt,
    lastSignInTime: user.metadata.lastSignInTime
  };

  try {
    await db.collection("user").doc(user.uid).create(userData);
    console.log(`用户文档创建成功: ${user.uid}`);
  } catch (error) {
    console.error(`创建用户文档失败: ${error}`);
  }
});

3. 备选方案：前端手动创建用户文档 #

如果触发器仍存在问题，可在前端登录成功后直接写入Firestore文档（需确保Firestore安全规则允许用户写入自己的文档）：

import { getAuth, signInWithCustomToken } from "firebase/auth";
import { getFirestore, doc, setDoc } from "firebase/firestore";
import Toast from "react-native-toast-message";

const db = getFirestore();

const signInWithClerk = async (getToken: any) => {
    const auth = getAuth();
    try {
        const token = await getToken({ template: "integration_firebase" });
        const userCredential = await signInWithCustomToken(auth, token);
        const user = userCredential.user;
        
        // 手动写入Firestore用户文档
        await setDoc(doc(db, "user", user.uid), {
            uid: user.uid,
            email: user.email,
            displayName: user.displayName,
            photoURL: user.photoURL,
            createdAt: new Date().toISOString()
        }, { merge: true }); // 使用merge避免重复创建时抛出错误
    } catch (error: any) {
        const errorCode = error.code;
        const errorMessage = error.message;
        Toast.show({
            type: "error",
            text1: "Error" + errorCode,
            text2: errorMessage,
        });
    }
};

export default signInWithClerk;

4. 排查函数日志 #

登录Firebase控制台，进入"函数"->"日志"，查看newUser函数的执行日志，确认是否有具体错误信息（如权限问题、字段缺失等）。

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