Firebase中startAfterDocument分页失效问题排查与解决

我写了一个包含两次Firebase请求的函数，用来获取指定登录用户（通过username）的评论。首次获取该用户的评论后，后续调用函数时不想重复加载这些评论，但现在第二次及之后调用时，snapshot变量始终为空，拿不到数据。请问怎么正确获取除首次存在querySnapshot里的评论之外的其他评论？

尝试过的代码片段 #

我针对snapshot变量试过这两段代码：

final snapshot = await FirebaseFirestore.instance
          .collection('comments')
          .where('postId', isEqualTo: widget.document['postId'])
          .where('username', isNotEqualTo: widget.username)
          .where('datePublished', isNotEqualTo: null)
          //.orderBy('datePublished', descending: true)
          .startAfterDocument(_lastDocument)
          .limit(_increment)
          .get();

另外一段尝试：

final snapshot = await FirebaseFirestore.instance
          .collection('comments')
          .where('postId', isEqualTo: widget.document['postId'])
          //.where('username', isNotEqualTo: widget.username)
         // .where('datePublished', isNotEqualTo: null)
          //.orderBy('datePublished', descending: true)
          .startAfterDocument(_lastDocument)
          .limit(_increment)
          .get();

完整函数代码 #

void _getComments() async {
    print('called function');
    setState(() {
      _isLoading = true;
    });

    QuerySnapshot querySnapshot;

    if (_lastDocument == null) {
      querySnapshot = await FirebaseFirestore.instance
          .collection('comments')
          .where('postId', isEqualTo: widget.document['postId'])
          .where('username', isEqualTo: widget.username)
          .orderBy('datePublished', descending: true)
          .get();

      if (querySnapshot.docs.isNotEmpty) {
        _lastDocument = querySnapshot.docs.last;
        _comments.addAll(querySnapshot.docs);
      }
    } else {
      final snapshot = await FirebaseFirestore.instance
          .collection('comments')
          .where('postId', isEqualTo: widget.document['postId'])
          //.where('username', isNotEqualTo: widget.username)
         // .where('datePublished', isNotEqualTo: null)
          //.orderBy('datePublished', descending: true)
          .startAfterDocument(_lastDocument)
          .limit(_increment)
          .get();


      if (snapshot.docs.isNotEmpty) {
       // _lastDocument = snapshot.docs.last;
        _lastDocumentOther = snapshot.docs.last;
        _comments.addAll(snapshot.docs);
      }
    }

    if (_comments.length >= _perPage) {
      setState(() {
        _hasMore = true;
      });
    }

    setState(() {
      _isLoading = false;
    });
  }

核心问题 #

1. 分页查询条件不一致：首次查询用了orderBy('datePublished', descending: true)，但后续查询注释掉了该条件。Firestore分页查询要求查询规则（包括orderBy）完全一致，否则startAfterDocument无法正确定位数据位置，直接返回空结果。
2. 筛选逻辑与分页标记冲突：首次查询是获取当前用户的评论，后续若要加载其他用户评论，既没有明确开启username != widget.username的筛选，又错误复用了首次查询的分页标记_lastDocument，导致每次都从当前用户评论的最后一条开始查找，自然找不到其他用户的数据。
3. 分页标记维护错误：后续查询用_lastDocumentOther存储新的分页终点，但下次查询仍以_lastDocument为起始点，逻辑断裂。

修复步骤 #

1. 拆分加载阶段，明确逻辑

新增状态变量标记当前用户评论是否加载完成，分阶段处理“当前用户评论”和“其他用户评论”的加载：

// 新增状态变量：标记当前用户评论是否加载完毕
bool _loadedCurrentUserComments = false;

2. 统一查询规则，维护正确分页标记

修复后的完整代码：

bool _loadedCurrentUserComments = false;
DocumentSnapshot? _lastDocumentOther;

void _getComments() async {
    print('called function');
    setState(() {
      _isLoading = true;
    });

    if (!_loadedCurrentUserComments) {
      // 第一阶段：加载当前用户的所有评论
      final querySnapshot = await FirebaseFirestore.instance
          .collection('comments')
          .where('postId', isEqualTo: widget.document['postId'])
          .where('username', isEqualTo: widget.username)
          .orderBy('datePublished', descending: true)
          .get();

      if (querySnapshot.docs.isNotEmpty) {
        _comments.addAll(querySnapshot.docs);
      }
      // 标记当前用户评论加载完成，初始化其他用户评论的分页起点
      _loadedCurrentUserComments = true;
      _lastDocumentOther = null;
    } else {
      // 第二阶段：分页加载其他用户的评论
      Query query = FirebaseFirestore.instance
          .collection('comments')
          .where('postId', isEqualTo: widget.document['postId'])
          .where('username', isNotEqualTo: widget.username)
          .orderBy('datePublished', descending: true)
          .limit(_increment);

      // 如果有分页起点，追加startAfter条件
      if (_lastDocumentOther != null) {
        query = query.startAfterDocument(_lastDocumentOther!);
      }

      final snapshot = await query.get();

      if (snapshot.docs.isNotEmpty) {
        _lastDocumentOther = snapshot.docs.last;
        _comments.addAll(snapshot.docs);
      } else {
        // 没有更多其他用户评论，关闭加载开关
        setState(() {
          _hasMore = false;
        });
      }
    }

    setState(() {
      _isLoading = false;
    });
  }

额外注意事项 #

• Firestore中，where与orderBy组合使用时需要创建对应的复合索引，如果控制台抛出索引错误，按照提示创建即可。
• 如果需要支持“当前用户评论分页加载”，可以把第一阶段的查询也改成分页模式，复用类似第二阶段的分页逻辑。

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