Firestore规则报错：'participantUids'属性未定义（list操作@L41）

问题场景 #

编写Firestore规则时，通过showId查询chats集合的聊天数据，触发错误：

Property participantUids is undefined on object. for 'list' @ L41

目标Chat文档确实包含participantUids字段，但在模拟器和真实数据库中均报错，调试日志仅显示showId字段。

错误根源 #

未理解Firestore规则不是过滤器的核心原则：
当用showId做查询过滤时，Firestore会先检查规则是否允许所有符合查询条件的文档被读取，而非仅检查最终返回的单个文档。如果集合中存在showId匹配但无participantUids字段的文档，规则会直接触发错误；更关键的是，规则要求request.auth.uid in resource.data.participantUids，但查询未基于participantUids做约束，Firestore无法确保所有匹配showId的文档都满足权限要求，因此直接拒绝请求。

解决方案 #

1. 优化安全规则（避免字段不存在报错） #

在chats的读取规则中，先校验participantUids字段存在性：

match /chats/{chatId} {
  allow read: if resource.data.participantUids != null && request.auth.uid in resource.data.participantUids;
  allow write: if true;
}

2. 修改查询逻辑（核心解决） #

必须将查询条件与权限规则对齐，新增基于participantUids的过滤，让Firestore能验证所有匹配文档的权限：

func getChat(withShowId showId: String, currentUserId: String) async throws -> Chat? {
    do {
        let chat = try await db
            .collection("chats")
            .whereField("showId", isEqualTo: showId)
            .whereField("participantUids", arrayContains: currentUserId) // 新增权限对齐的过滤条件
            .getDocuments()
        
        guard !chat.documents.isEmpty && chat.documents[0].exists && chat.documents.count == 1 else { return nil }
        
        let fetchedChat = try chat.documents[0].data(as: Chat.self)
        return fetchedChat
    } catch Swift.DecodingError.keyNotFound {
        throw FirebaseError.dataNotFound
    } catch {
        throw FirebaseError.connection(
            message: "Failed to fetch show chat.",
            systemError: error.localizedDescription
        )
    }
}

关键说明 #

Firestore安全规则是前置验证机制，而非事后过滤：

• 规则会检查查询可能返回的所有文档是否满足权限条件，而非仅检查实际返回的文档
• 查询条件必须与规则的权限逻辑对齐，让Firestore能高效验证权限，避免因无法确认所有匹配文档的权限而拒绝请求

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