Swift Firebase Database：按子键筛选数据及查询问题排查

数据库结构 #

{
    "numbers": [0, 1, 2, 3, 4, 5],
    "models": {
        "random_string_key": {
            "name": "model_name",
            "value": "some_value"
        },
        "random_string_key-2": {
            "name": "Name",
            "value": "any value"
        }
    }
}

问题1：获取numbers数组中所有小于3的值 #

错误分析 #

• 查询条件错误：queryEnding(beforeValue: 2) 只会获取值小于2的元素（即0、1），而你需要的是小于3的元素，应该用 queryEnding(beforeValue: 3)。
• 离线报错：client offline with no active listeners and no matching disk cache entries 说明当前设备处于离线状态，且该查询的结果没有缓存到本地。getData() 是单次数据获取，离线时如果没有对应缓存就会失败，建议确保设备在线，或者先通过 observe(.value) 添加监听来缓存数据。

正确代码 #

let ref = Database.database().reference()
let refNumbers = ref.child("numbers")

// 获取所有小于3的值
refNumbers
    .queryOrderedByValue()
    .queryEnding(beforeValue: 3)
    .getData(completion: { error, snapshot in
        if let error = error {
            print("查询错误：\(error.localizedDescription)")
            return
        }
        guard let values = snapshot.value as? [Int] else {
            print("数据格式错误")
            return
        }
        print("小于3的值：\(values)") // 输出 [0,1,2]
    })

问题2：筛选models中value等于"some_value"的模型 #

错误分析 #

• 第一个查询错误：queryEqual(toValue: "some_value", childKey: "value") 中的 childKey 参数是用来匹配节点的键名，而非子节点的字段名，所以这个写法完全不符合需求。
• 第二个查询的离线报错：和问题1原因一致，离线且无缓存导致失败。另外，若在线仍无结果，需要检查Firebase控制台是否为 models 节点的 value 字段配置了索引——Firebase Realtime Database需要为查询的子节点字段添加索引才能高效筛选，否则可能返回空或报错。

正确代码 #

第一步：配置索引（Firebase控制台）

在Firebase控制台的Realtime Database规则中，添加针对 models 节点 value 字段的索引：

{
  "rules": {
    ".read": true, // 根据实际需求调整权限
    ".write": true,
    "models": {
      ".indexOn": ["value"] // 添加这行配置
    }
  }
}

第二步：查询代码

let modelsRef = ref.child("models")

modelsRef
    .queryOrdered(byChild: "value")
    .queryEqual(toValue: "some_value")
    .getData(completion: { error, snapshot in
        if let error = error {
            print("查询错误：\(error.localizedDescription)")
            return
        }
        guard let models = snapshot.value as? [String: [String: String]] else {
            print("数据格式错误")
            return
        }
        // 遍历筛选后的模型
        for (key, model) in models {
            print("模型键：\(key)，名称：\(model["name"] ?? "")，值：\(model["value"] ?? "")")
        }
    })

关于"能否在获取数据时直接筛选" #

可以直接在获取数据时通过Firebase的查询API进行云端筛选，但需要满足两个条件：

• 正确使用查询方法（如 queryOrderedByChild/queryOrderedByValue 搭配筛选条件）
• 为查询的字段配置对应的索引（针对子节点字段的查询）

如果不满足上述条件，就只能先获取全部数据再本地筛选，但云端筛选能减少带宽消耗和本地处理压力。

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