Firestore安全规则多字段验证：简化多字段键与类型校验方法

你可以通过定义字段-类型映射对象，结合Firestore规则的循环能力批量完成校验，避免逐个字段编写重复逻辑，尤其适合字段数量多的集合。

核心思路 #

1. 定义一个包含所有允许字段及其对应类型的映射函数
2. 校验请求数据的所有字段都属于允许列表（无额外字段）
3. 批量校验每个字段的类型是否匹配映射中的定义

代码示例（针对多字段集合） #

比如针对一个包含多个字段的Users集合，规则可以这样写：

match /Users/{userId} {
  // 维护允许的字段与对应类型，新增/修改字段只需更新这里
  function allowedFields() {
    return {
      name: string,
      age: number,
      isActive: bool,
      lastLogin: timestamp,
      preferences: map
    };
  }

  function validUserData() {
    let requestData = request.resource.data;
    let allowed = allowedFields();
    
    // 校验1：没有额外字段（请求字段都是允许的）
    let noExtraFields = requestData.keys().toSet().isSubsetOf(allowed.keys().toSet());
    
    // 校验2：所有提供的字段类型都匹配
    let allTypesMatch = requestData.keys().every(key => requestData[key] is allowed[key]);
    
    return noExtraFields && allTypesMatch;
  }

  allow create, update: if isSuperAdmin() && validUserData();
  allow delete: if isSuperAdmin();
}

针对你的GameAdmins集合改写 #

把原来的规则用这种方式重构后，代码会更简洁且易于维护：

match /GameAdmins/{adminId} {
  function allowedFields() {
    return {
      admin: bool,
      superAdmin: bool
    };
  }

  function validAdminData() {
    let requestData = request.resource.data;
    let allowed = allowedFields();
    
    let requestKeys = requestData.keys().toSet();
    let allowedKeys = allowed.keys().toSet();
    
    // 如果要求创建/更新时必须包含所有字段，用 requestKeys == allowedKeys
    // 如果允许部分字段可选，改用 requestKeys.isSubsetOf(allowedKeys)
    return (requestKeys == allowedKeys) && requestData.keys().every(key => requestData[key] is allowed[key]);
  }
  
  allow create, update: if isSuperAdmin() && validAdminData();
  allow delete: if isSuperAdmin();
}

优势说明 #

• 维护成本低：新增或修改字段时，只需更新allowedFields()中的映射，无需改动校验逻辑
• 代码简洁：不管字段数量多少，校验逻辑都是固定的几行代码
• 灵活性高：通过isSubsetOf或==可以轻松切换“可选字段”或“必填所有字段”的校验规则

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