iOS Firebase：如何用queryOrderedByChild查询多值数组子节点？

我明白你的痛点——Firebase Realtime Database的queryEqual(toValue:)确实只支持单个值匹配，没法直接传数组来批量查询包含任一邮箱的节点。这里有几个可行的解决方案，你可以根据自己的场景选择：

解决方案1：多查询合并结果（适合「包含任意目标邮箱」的场景） #

如果你的需求是找出user_ids数组包含任意一个目标邮箱的节点，可以循环遍历邮箱数组，对每个邮箱单独发起queryEqual(toValue:)查询，最后合并结果并去重（避免同一个节点被多个邮箱匹配到多次）。

用DispatchGroup可以确保所有查询完成后再统一处理结果：

let targetEmails = ["krishna.vutti@gmail.com", "another@example.com"]
let ref = Database.database().reference().child(Constants.ACTIVES)
var uniqueResults = [DataSnapshot]()
let group = DispatchGroup()
let resultQueue = DispatchQueue(label: "com.yourapp.firebase.results") // 保证线程安全

for email in targetEmails {
    group.enter()
    ref.queryOrdered(byChild: "user_ids")
       .queryEqual(toValue: email)
       .observeSingleEvent(of: .value) { snapshot in
           defer { group.leave() } // 无论成功失败都标记任务完成
           
           resultQueue.sync {
               // 遍历当前查询返回的所有节点
               for child in snapshot.children {
                   guard let childSnapshot = child as? DataSnapshot else { return }
                   // 检查是否已存在，避免重复添加
                   if !uniqueResults.contains(where: { $0.key == childSnapshot.key }) {
                       uniqueResults.append(childSnapshot)
                   }
               }
           }
       }
}

// 所有查询完成后回到主线程处理结果
group.notify(queue: .main) {
    print("最终匹配的节点数量：\(uniqueResults.count)")
    // 在这里更新UI或处理匹配到的数据
}

解决方案2：调整数据结构（更高效的长期方案） #

如果你的数据量较大，多查询的方式可能会有性能瓶颈，建议把user_ids从数组改成字典结构，比如：

"ACTIVES": {
  "sample_node_1": {
    "user_ids": {
      "krishna.vutti@gmail.com": true,
      "john.doe@example.com": true
    },
    "other_field": "some_value"
  }
}

这种结构下，Firebase的查询效率会更高（因为字典是键值对查找，而数组需要遍历每个元素）。你可以用queryOrderedByChild("user_ids/krishna.vutti@gmail.com").queryEqual(toValue: true)来精准查询包含该邮箱的节点，同样可以结合多查询合并的方式处理多个邮箱。

如果需要查询同时包含多个邮箱的节点，这种结构也更适合后续的客户端过滤，甚至可以在节点中额外维护一个哈希组合字段（比如把邮箱按排序后拼接成字符串），但这种方式需要额外维护数据一致性，适合复杂场景。

解决方案3：客户端全量过滤（适合小数据集） #

如果ACTIVES节点下的数据量很小（比如只有几十条），可以先下载所有节点，然后在客户端筛选出符合条件的结果：

let targetEmails = ["krishna.vutti@gmail.com", "another@example.com"]
let ref = Database.database().reference().child(Constants.ACTIVES)

ref.observeSingleEvent(of: .value) { snapshot in
    var matchedNodes = [DataSnapshot]()
    
    for child in snapshot.children {
        guard let childSnapshot = child as? DataSnapshot else { continue }
        // 解析user_ids数组
        guard let userIds = childSnapshot.childSnapshot(forPath: "user_ids").value as? [String] else { continue }
        
        // 检查是否有任意一个目标邮箱在数组中
        let hasMatchingEmail = userIds.contains { targetEmails.contains($0) }
        if hasMatchingEmail {
            matchedNodes.append(childSnapshot)
        }
    }
    
    print("匹配到的节点：\(matchedNodes)")
    // 处理结果
}

这种方式实现简单，但缺点是会下载所有数据，数据量大时会浪费带宽和设备资源，仅适合小数据集场景。

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