如何通过Firestore安全规则禁止客户端创建文档任意字段？

我之前在项目里也碰到过一模一样的问题——明明已经给现有字段加了规则，客户端还是能塞一堆随机字段进来，尤其是有可选字段的时候，限制字段数量或者简单的字段名校验根本不管用。后来试了几个方案，这里分享下最实用的几种：

1. 明确指定允许的字段列表（推荐最佳方案） #

这种方式最直接也最安全，核心是用request.resource.data.keys().hasOnly()方法，把所有必填字段和可选字段都列进允许的列表里。这样不管客户端提交的是必填字段、部分可选字段还是全部可选字段，只要没有超出这个列表的字段，就会被允许。

示例规则：

match /users/{userId} {
  allow update: 
    // 确保提交的所有字段都在允许列表内
    request.resource.data.keys().hasOnly(['fullName', 'email', 'phone', 'address'])
    // 同时校验必填字段的合法性（比如fullName必须是字符串且存在）
    && request.resource.data.fullName is string
    && request.resource.data.fullName != '';
}

这里的hasOnly(['fullName', 'email', 'phone', 'address'])会严格检查：客户端提交的所有字段必须是这四个里面的，不管有没有提交phone或address这类可选字段，只要不出现列表外的random123之类的字段就没问题。

2. 按前缀规则允许动态字段 #

如果你的业务需要允许一类有统一命名规则的动态字段（比如用户自定义的扩展字段都以custom_开头），可以用every()方法遍历所有提交的字段，校验每个字段要么在基础允许列表里，要么符合前缀规则。

示例规则：

match /products/{productId} {
  allow update: 
    request.resource.data.keys().every(key => 
      // 基础字段或符合前缀规则的字段都允许
      key in ['name', 'price', 'stock'] || key.startsWith('custom_')
    )
    // 基础字段的合法性校验
    && request.resource.data.price is number
    && request.resource.data.price > 0;
}

这种方式兼顾了灵活性和安全性，既允许合法的动态字段，又能阻止完全随机的垃圾字段。

3. 基于现有字段允许新增可选字段 #

如果你的文档可能存在不同的现有字段（比如不同用户的文档字段不完全一致），同时需要允许添加指定的可选字段，可以结合diff()方法获取新增字段，再校验新增字段是否在允许的范围内。

示例规则：

match /documents/{docId} {
  allow update: 
    let addedFields = request.resource.data.diff(resource.data).addedKeys();
    // 新增字段只能是允许的可选字段
    addedFields.hasOnly(['metadata', 'tags'])
    // 所有提交的字段要么是原文档已有的，要么是允许新增的
    && request.resource.data.keys().hasOnly([...resource.data.keys(), 'metadata', 'tags']);
}

这个方案适合文档结构有动态变化的场景，既能保护原有的字段，又能控制新增的可选字段范围。

总结一下，第一种明确指定允许字段列表的方案是最推荐的，因为它逻辑清晰、安全性最高，能彻底杜绝随机垃圾字段的上传。如果有动态字段的需求，再根据业务场景选择第二种或第三种方案。

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