Firestore安全规则首次校验失败二次成功的问题排查求助

问题诊断与解决方案 #

1. 排查React Strict Mode的重复执行 #

开发环境下React Strict Mode会重复触发副作用函数、状态更新逻辑，可能导致updateSettings被意外调用两次。第一次执行时用户认证状态可能未完全初始化（request.auth为null），触发规则校验失败；第二次执行时认证状态就绪，校验通过。

解决方式：

• 临时关闭React Strict Mode（移除index.js中的<React.StrictMode>包裹），观察是否仍出现两次校验。
• 若确认为Strict Mode导致，调整认证监听逻辑，确保在auth状态就绪后执行数据库操作：

import { onAuthStateChanged } from "firebase/auth";
import { auth } from "./firebase-config";

useEffect(() => {
  const unsubscribe = onAuthStateChanged(auth, (user) => {
    if (user && updatedSettings) {
      updateSettings(user.uid, updatedSettings);
    }
  });
  return unsubscribe;
}, [updatedSettings]);

2. 修正Firestore安全规则逻辑 #

当前规则的write条件未区分操作类型，可能导致歧义：

• updateDoc操作依赖resource.data（文档现有数据），若第一次校验时未正确获取到resource，会导致docData().userId校验失败。
• 拆分操作类型，明确各场景的校验逻辑：

rules_version = '2';

service cloud.firestore {
  match /databases/{database}/documents {
    function isAuthenticated() {
      return request.auth != null;
    }

    function isOwner(userId) {
      return isAuthenticated() && request.auth.uid == userId;
    }

    function docData() {
      return resource.data;
    }

    function newDocData() {
      return request.resource.data;
    }

    match /settings/{settingsId} {
      allow create: if isOwner(newDocData().userId);
      allow update: if isOwner(docData().userId);
      allow delete: if isOwner(docData().userId);
      allow read: if isOwner(docData().userId);
    }
  }
}

3. 精准调试规则失败原因 #

• 使用规则模拟器：在Firebase控制台进入Firestore规则页面，打开规则模拟器，模拟更新操作，传入真实的用户uid、请求数据，查看每一步规则校验的结果，定位具体失败的条件。
• 添加调试日志：在规则函数中加入debug()输出变量，查看request.auth、userId的实际取值：

function isOwner(userId) {
  debug("request.auth:", request.auth);
  debug("target userId:", userId);
  return request.auth != null && request.auth.uid == userId;
}

4. 验证更新数据的正确性 #

在调用updateDoc前打印传入的数据，确认userId字段存在且与当前用户uid一致：

export async function updateSettings(userId?: string, updatedSettings?: Settings) {
  if (!updatedSettings || !userId) {
    throw new Error("Updated settings and user ID are required");
  }
  const dbData = updatedSettings.toDbObject(true);
  console.log("Update payload:", dbData); // 检查userId字段
  const settingsDocRef = doc(firestore, `${DB_PATH_SETTINGS}/${userId}`);
  await updateDoc(settingsDocRef, dbData);
}

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