React/Next.js中Firestore规则request.auth始终为null的问题

排查方向与解决方案 #

• 确保Firebase实例全局统一
  检查updateUserLicense函数使用的auth和db实例，必须和登录组件导入的是同一个全局实例，禁止在不同文件中重复初始化Firebase。示例初始化文件：

  // firebase/config.js
  import { initializeApp } from "firebase/app";
  import { getAuth } from "firebase/auth";
  import { getFirestore } from "firebase/firestore";
  
  const firebaseConfig = { /* 你的项目配置 */ };
  const app = initializeApp(firebaseConfig);
  export const auth = getAuth(app);
  export const db = getFirestore(app);
  

  所有组件、函数均需从该文件导入实例，避免出现多实例导致的认证状态隔离。

• 确认调用Firestore时的认证状态有效性
  在Next.js 13环境下，区分客户端/服务端调用场景：

  • 客户端组件调用：先校验auth.currentUser存在再执行操作，避免状态延迟导致的空值：

    async function updateUserLicense() {
      const user = auth.currentUser;
      if (!user) return;
      const userDoc = doc(db, 'users', user.uid);
      await updateDoc(userDoc, { license: 'active' });
    }
    

  • 服务端组件调用：手动传递认证令牌，确保请求携带身份信息：

    import { auth } from '@/firebase/config';
    import { getToken } from 'firebase/auth';
    import { doc, updateDoc } from 'firebase/firestore';
    
    async function updateUserLicense(uid) {
      const token = await getToken(auth.currentUser);
      const userDoc = doc(db, 'users', uid);
      await updateDoc(userDoc, { license: 'active' }, {
        headers: { Authorization: `Bearer ${token}` }
      });
    }
    

• 修正认证状态同步延迟问题
  即便updateUserLicense未使用Jotai atom，onAuthStateChanged中atom设置为undefined说明认证状态存在同步延迟。可在触发函数前确保认证流程完全完成：

  auth.onAuthStateChanged(async (user) => {
    if (user) {
      // 等待重定向认证结果（如果使用第三方登录）
      await getRedirectResult(auth);
      await updateUserLicense(user.uid);
    }
  });
  

• 核对Firestore安全规则逻辑
  确保规则语法和权限逻辑正确，比如针对用户文档的读写规则：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /users/{userId} {
        allow read, write: if request.auth != null && request.auth.uid == userId;
      }
    }
  }
  

  注意操作的文档ID必须与request.auth.uid匹配，若操作其他集合需调整规则条件。

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