React项目向Firestore写数据提示caller does not have permission报错求解

1. 优先排查Firestore规则过期问题 #

这是无修改情况下突然触发权限报错的最高频原因：

• Firebase默认提供的测试规则自带30天有效期，规则模板为allow read, write: if request.time < timestamp.date(202x, x, x);，到期后所有读写请求会被自动拒绝，哪怕你从未主动修改过规则。
• 直接登录Firebase控制台，进入Firestore数据库的「规则」标签页，即可看到是否有规则过期的红色提示。

2. 排查react-router关联的认证状态异常 #

react-router本身不会直接触发Firestore权限错误，但新增的路由逻辑可能影响Firebase鉴权时机：

• 检查你新增的路由守卫/拦截逻辑，是否在Firebase的onAuthStateChanged鉴权回调完成前，就触发了Firestore写请求
• 确认受保护路由下的组件执行写操作前，Firebase的currentUser对象不为空，未登录状态下的请求会被需要登录校验的规则直接拦截

3. 规则调试步骤 #

你可以先临时将Firestore规则改为全开放模式，验证是否为规则本身的问题：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

• 保存规则后等待1分钟生效，再测试写操作：如果不再报错，说明是规则配置问题，逐步调整权限、补充你需要的鉴权条件即可。
• 如果修改全开放规则后仍然报错，检查项目内的Firebase初始化配置，确认项目ID、API密钥等参数未被误改。

4. 代码优化建议 #

给Firestore写请求补充错误捕获，避免抛出未处理的Promise错误，同时可以拿到更详细的报错信息定位问题：

// 示例写法
db.collection("你的集合名").add({
  // 写入的数据
}).then(res => {
  console.log("写入成功", res)
}).catch(err => {
  console.error("写入失败，错误码：", err.code, "错误信息：", err.message)
})

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