Firestore规则中resource.data.displayName报未定义但数据库已存在该字段

常见原因及对应解决方法 #

• 规则匹配路径与实际访问路径不匹配
  确认你的规则匹配的集合路径与你实际读取的文档路径完全一致，例如你要操作users集合下的文档，规则必须正确匹配match /users/{docId} { ... }，如果通配符层级写错、集合名拼写错误，会导致resource指向非预期的文档，自然读取不到displayName字段。
• 未先判断文档存在性
  访问resource.data前必须先确认请求的文档真实存在，在规则开头新增exists(resource)判断即可：

  allow read: if exists(resource) && resource.data.displayName == "xxx";
  

  如果访问的文档不存在，resource会返回null，此时读取任何字段都会触发未定义报错。
• 字段名大小写不匹配
  Firestore字段名大小写完全敏感，确认数据库中存储的字段名就是displayName，而非Displayname、display_name等其他写法，大小写不一致会直接判定为字段不存在。
• 规则场景使用错误
  resource指代请求发起前就已经存在的数据库文档，如果你是在create操作的规则中使用resource，此时文档还未创建，resource本身为null，自然读不到字段。创建场景下要读取提交的字段值，请改用request.resource.data.displayName。
• 规则缓存问题
  可以在Firebase控制台的规则 playground 中输入实际的文档路径做模拟测试，查看模拟器返回的resource.data结构，确认字段是否真的被规则侧识别到，如果是缓存问题，重新保存一次规则即可生效。

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