迁移至react-native-firebase后Firebase实时数据库Priority值缺失问题

我正将应用从Firebase Web（V8）迁移至react-native-firebase（相比升级到Web V9，重构工作量更小），但遇到了问题：使用Priority值存储实时数据库容器中对象的排序标识，读取DataSnapshot时无法获取该值。顶层快照包含priority值，但通过snap.child('child1')或snap.forEach()访问子快照时，子快照没有.priority属性。

现有代码（已运行5年，添加调试打印） #

subscribeFB() {
    if (!this.unlistenFB) {
      this.unlistenFB = this.user.child('Counternames').on(
        'value',
        (snap) => {
          // Counternames变化时同时获取当前时间戳
          this.getTimestamps(snap);
        },
        (error) => {
          info('Counternames subscription cancelled because', error);
        }
      );
    }
  }

  getTimestamps(snap) {
    this.user.child('Timestamps').once(
      'value',
      (tsSnap) => {
        setTimeout(
          () =>
            MultiActions.setCounters({
              counterSnap: snap,
              timestamps: tsSnap.val(),
            }),
          0
        );
      },
      (error) => {
        info('Could not get timestamps because', error);
      }
    );
  }
// 之后在setCounters中使用两个快照

setCounters(snaps) {
 [...]
     if ( timestamps.sequence > this.state.timestamps.sequence) {
        debug('Getting new sequence from FB');
        // 从FB获取序列
        var CounternameSnap = snaps.counterSnap;
        var cns = CounternameSnap.exportVal();
        debug(`CounternameSnap exportVal ${JSON.stringify(cns, null, 2)}`);

        var ch = CounternameSnap.child('-MH3NnGU5iM0eakrd7ZS').exportVal();
        debug(`Counter 44 exportVal ${JSON.stringify(ch)}`);

        CounternameSnap.forEach((ctr) => {
          var p = ctr.getPriority();

          debug(`Counter priority ${p} has key ${ctr.key}, val ${ctr.val()}`);
          // 处理priority...
        });
}

调试输出 #

当另一设备修改计数器顺序时，.on监听器触发，输出如下：

LOG  MultiStore:debug Getting new sequence from FB +2ms
LOG  MultiStore:debug CounternameSnap exportVal {
 ".value": {
   "-MH3MqLK32gCi0pqBUg3": "Counter 33",
   "-MH4yucF8rmeewGbPAVI": "Counter 55",
   "-MH3NnGU5iM0eakrd7ZS": "Counter 44",
   "-NuBYkNVlAUIUeoQQCKA": "Counter 66",
   "-MGQOBLgEvEekOg6geQI": "Counter 11",
   "-MGzzZXdUwpBr8RlLLE-": "Counter 22"
 },
 ".priority": null
} +1ms
LOG  MultiStore:debug Counter 44 exportVal {".value":"Counter 44"} +1ms
LOG  MultiStore:debug Counter priority undefined has key -MGzzZXdUwpBr8RlLLE-, val Counter 22 +2ms
LOG  MultiStore:debug Counter priority undefined has key -MH4yucF8rmeewGbPAVI, val Counter 55 +1ms
LOG  MultiStore:debug Counter priority undefined has key -MH3NnGU5iM0eakrd7ZS, val Counter 44 +1ms
LOG  MultiStore:debug Counter priority undefined has key -MH3MqLK32gCi0pqBUg3, val Counter 33 +0ms
LOG  MultiStore:debug Counter priority undefined has key -MGQOBLgEvEekOg6geQI, val Counter 11 +1ms
LOG  MultiStore:debug Counter priority undefined has key -NuBYkNVlAUIUeoQQCKA, val Counter 66 +1ms

数据确认 #

导出的容器数据显示子节点确实存在.priority值（Firebase控制台不显示）：

{
 "-MGQOBLgEvEekOg6geQI": {
   ".value": "Counter 11",
   ".priority": 4
 },
 "-MGzzZXdUwpBr8RlLLE-": {
   ".value": "Counter 22",
   ".priority": 0
 },
 "-MH3MqLK32gCi0pqBUg3": {
   ".value": "Counter 33",
   ".priority": 1
 },
 "-MH3NnGU5iM0eakrd7ZS": {
   ".value": "Counter 44",
   ".priority": 2
 },
 "-MH4yucF8rmeewGbPAVI": {
   ".value": "Counter 55",
   ".priority": 3
 },
 "-NuBYkNVlAUIUeoQQCKA": {
   ".value": "Counter 66",
   ".priority": 5
 }
}

相关版本：react-native: 0.70.15，react-native-firebase: 19.1.1。
[更新]：已排查离线持久化问题，开启后问题依旧。

问题原因 #

这是react-native-firebase底层依赖的Firebase SDK（V9+）的行为变更导致的。Firebase V9+的实时数据库SDK在处理value事件快照时，默认不会自动解析子节点的.priority元数据，而Web V8会自动处理这部分元数据并暴露给getPriority()方法。从调试输出的exportVal()结果也能看出：顶层快照的导出结果里没有包含子节点的.priority，说明SDK在获取快照时没有把这部分数据带回来。

解决方案 #

1. 改用orderByPriority()查询
   如果核心需求是按Priority排序，直接在查询时添加orderByPriority()，这样SDK会自动处理排序，同时在快照中保留子节点的优先级信息：

   this.unlistenFB = this.user.child('Counternames')
     .orderByPriority() // 添加这一行
     .on('value', (snap) => {
       this.getTimestamps(snap);
     }, (error) => {
       info('Counternames subscription cancelled because', error);
     });
   

   添加这个查询后，子快照的getPriority()方法应该能正常返回对应的值。

2. 手动解析导出的原始数据
   如果无法修改查询方式，可以通过手动解析顶层快照的原始导出数据来提取优先级：

   // 注意：需确保SDK返回的原始数据包含.priority，可能需要调整查询参数
   const rawData = CounternameSnap.exportVal()['.value'];
   Object.keys(rawData).forEach(key => {
     // 这里需要直接从数据库拉取包含元数据的完整结构，当前exportVal输出不包含，可尝试用REST API获取原始数据
     // 示例结构（假设已获取完整元数据）：
     // const item = rawData[key];
     // const priority = item['.priority'];
     // const value = item['.value'];
     // 处理数据
   });
   

3. 迁移到自定义排序字段
   Firebase的.priority是旧特性，官方更推荐使用自定义字段（比如sortOrder）来存储排序标识，这样在所有SDK中都能一致地读取和处理，避免元数据兼容性问题：

   • 批量更新现有数据，将.priority值迁移到自定义字段
   • 修改查询为orderByChild('sortOrder')
   • 后续排序操作直接操作这个自定义字段

验证 #

测试添加orderByPriority()后的快照输出，子节点的getPriority()应该能返回正确的数值。如果还是不行，可以尝试降级react-native-firebase到稍早版本（比如18.x），确认是否是新版本的SDK变更导致的，但长期来看，迁移到自定义排序字段是更稳定的方案。

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