Flutter中Firebase Firestore调用orderBy排序结果错乱问题

我正在使用Flutter开发课程类应用，课程模块下设有用于展示剧集内容的eps子集合。创建剧集时我会传入episodeNum字段值作为剧集编号，期望通过Firebase提供的orderBy函数基于该字段对剧集进行升序排序，但实际排序效果不符合预期：排序逻辑确实被触发，但返回的排序结果完全错乱。

读取剧集实现代码 #

@override
Stream<List<EpisodesModel>> readEpisode({
  required id,
}) {
  return FirebaseFirestore.instance
      .collection('courses')
      .doc(id)
      .collection('eps')
      .orderBy('episodeNum', descending: false) // 创建课程时存入的剧集编号字段
      .snapshots()
      .map((snapshot) => snapshot.docs
          .map((doc) => EpisodesModel.fromJson(doc.data()))
          .toList());
}

实际排序效果 #

如果定位问题需要补充其他相关代码，可随时告知。

排序结果错乱是因为Firestore中episodeNum字段存成了字符串类型，不是数值类型。
Firestore对字符串字段做orderBy排序时遵循字典序规则，会按字符逐位比较，就会出现1、10、11、2、20、3这种不符合数字大小逻辑的排序结果，和截图里的错乱表现完全匹配。

• 从写入端修正（推荐）：创建剧集文档时，确保传给episodeNum字段的值是int类型，不要传字符串格式的数字，避免Firestore将该字段识别为字符串类型。
• 修复存量数据：如果已经有大量已存入的剧集数据，写一个批量更新脚本，遍历对应课程下的所有eps文档，把字符串格式的episodeNum转成整数后覆盖原字段即可。
• 临时兼容方案（仅适合小数据量场景）：如果暂时没法修改库中的字段类型，可以在Dart层拿到查询结果后手动做数值排序，代码如下：

@override
Stream<List<EpisodesModel>> readEpisode({
  required id,
}) {
  return FirebaseFirestore.instance
      .collection('courses')
      .doc(id)
      .collection('eps')
      .snapshots()
      .map((snapshot) {
        final episodeList = snapshot.docs
            .map((doc) => EpisodesModel.fromJson(doc.data()))
            .toList();
        // 按episodeNum数值升序排序
        episodeList.sort((a, b) => a.episodeNum.compareTo(b.episodeNum));
        return episodeList;
      });
}

注意：临时方案无法支持Firestore服务端分页、范围查询等能力，数据量稍大就会出现性能问题，仅做应急使用，优先选择修正字段存储类型的方案。

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