Flutter中Firebase实时数据库iOS端获取子节点数据异常

问题描述 #

在Flutter移动应用中使用Firebase实时数据库存储IoT设备实时数据，通过云函数每日生成按UsersData/{uid}/analytics/年/月/日嵌套结构存储的分析数据。编写代码获取指定日期的单日分析数据时，Android端可正常返回目标数据，但iOS端（测试iOS12、iOS16）返回整个analytics父节点的所有数据。

环境信息 #

• Flutter版本：3.7.10
• Firebase相关依赖版本：
  • firebase_auth: ^4.9.0
  • firebase_core: ^2.15.1
  • firebase_core_platform_interface: ^4.8.0
  • firebase_database: ^10.2.5
  • firebase_storage: ^11.2.6

问题代码 #

/// Getting Analytics for today Data
Future getAnalyticsforSelectedDate({
  required String uid,
  required DateTime selectedDate,
}) async {
  String selectedYear = selectedDate.year.toString();
  String selectedMonth = selectedDate.month.toString();
  String selectedDay = selectedDate.day.toString();

// Format Add a zero in front of single digit date such as
// e.g. Turn 9/9/2023 into 09/09/2023

  if (selectedDate.day >= 10) {
    selectedDay = selectedDate.day.toString();
  } else {
    selectedDay = "0" + selectedDate.day.toString();
  }

  if (selectedDate.month >= 10) {
    selectedMonth = selectedDate.month.toString();
  } else {
    selectedMonth = "0" + selectedDate.month.toString();
  }

  try {
    final data = await _db
        .child(
            "UsersData/$uid/analytics/$selectedYear/$selectedMonth/$selectedDay")
        .get();

    log("Date = $selectedDay/$selectedMonth/$selectedYear");
    log("${Platform.isIOS ? "IOS Results" : "Android Result"}:: ${data.value} ");

    return data.value;
  } catch (e) {
    log("@getAnalyticsforSelectedDate " + e.toString());
  }
}

排查方向与解决方案 #

1. 简化日期格式化逻辑，避免手动补零错误 #

手动判断补零的逻辑存在冗余，且可能因分支错误导致路径格式不一致。改用padLeft方法统一生成两位格式的月/日字符串：

String selectedYear = selectedDate.year.toString();
String selectedMonth = selectedDate.month.toString().padLeft(2, '0');
String selectedDay = selectedDate.day.toString().padLeft(2, '0');

替换原有的if-else补零代码，确保生成的路径字符串在Android和iOS端完全一致。

2. 检查Firebase数据库权限规则 #

如果数据库规则仅授予analytics父节点的读取权限，iOS SDK可能因无法精准访问子节点，返回父节点数据作为 fallback。需确保规则允许访问指定深度的子节点：

{
  "rules": {
    "UsersData": {
      "$uid": {
        "analytics": {
          "$year": {
            "$month": {
              "$day": {
                ".read": "auth != null && auth.uid == $uid",
                ".write": "auth != null && auth.uid == $uid"
              }
            }
          }
        }
      }
    }
  }
}

3. 强制从服务器获取数据，避免缓存干扰 #

iOS端Firebase数据库默认启用本地缓存，可能返回旧的父节点缓存数据。可强制从服务器拉取最新数据：

final data = await _db
    .child("UsersData/$uid/analytics/$selectedYear/$selectedMonth/$selectedDay")
    .get(GetOptions(source: Source.server));

若无需离线功能，也可全局禁用缓存：

FirebaseDatabase.instance.setPersistenceEnabled(false);

4. 验证路径一致性 #

在代码中打印完整节点路径，对比Android和iOS的日志输出，确认路径无大小写、格式差异：

String fullPath = "UsersData/$uid/analytics/$selectedYear/$selectedMonth/$selectedDay";
log("Request path: $fullPath");
final data = await _db.child(fullPath).get();

5. 升级Firebase依赖版本 #

当前使用的firebase_database: ^10.2.5可能存在iOS端路径解析bug，尝试升级至最新稳定版本：
修改pubspec.yaml：

firebase_database: ^10.4.0 # 替换为最新稳定版本

执行flutter pub get更新依赖后重新测试。

内容的提问来源于stack exchange，提问作者imad-rashid