Firestore组合whereEqualTo、orderBy和limit(1)查询失效求助

我需要从Workout集合中查询指定routine的最新训练记录：使用whereEqualTo匹配routineKey，按startTimeStamp降序排序，限制返回1条结果并获取其Key/Id。但该组合查询失效，whereEqualTo和orderBy单独使用均正常，请问问题出在哪里？

代码如下：

fm.getColRefWorkout()
  .whereEqualTo("routineKey", routineKey)
  .orderBy("startTimeStamp", Query.Direction.DESCENDING)
  .limit(1)
  .get()
  .addOnSuccessListener(new OnSuccessListener<QuerySnapshot>() {
      @Override
      public void onSuccess(QuerySnapshot documentSnapshots) {
          workoutKey = documentSnapshots.getDocuments().get(0).getId();
          //To stuff with this workoutKey
      }
  });

这种情况我之前排查过好多次，大概率是Firestore复合索引缺失导致的！下面给你拆解原因和解决步骤：

• 核心原因：组合查询需要复合索引
  Firestore的单字段索引只能满足单一的过滤或排序需求，但当你同时使用whereEqualTo（过滤）和orderBy（排序）时，必须手动创建对应的复合索引。单独使用这两个方法时Firestore会自动生成单字段索引，所以没问题，但组合起来就不行了。

• 最快的修复方式：用日志里的自动生成链接
  运行你的代码后，去查看应用的日志（Android看Logcat，后端看控制台输出），Firestore会直接打印一个带有索引创建链接的错误提示，点击这个链接就能跳转到Firebase控制台，系统会自动帮你填好索引的配置，你只需要确认保存就行，等待几分钟索引构建完成后再测试查询就正常了。

• 手动创建索引的步骤
  如果没找到日志链接，也可以手动去Firebase控制台操作：

  1. 进入Firebase控制台 → 打开你的项目 → 选择Firestore数据库
  2. 切换到索引标签页 → 点击复合索引 → 点击添加索引
  3. 集合ID填Workout，然后添加两个字段：
     • 第一个字段选routineKey，排序方式选升序或降序都可以（因为是equalTo匹配，不影响）
     • 第二个字段选startTimeStamp，排序方式选降序
  4. 给索引起个名字（可选），然后点击保存，等待索引构建完成（一般3-5分钟）

• 额外检查项

  • 确认startTimeStamp的数据类型是数字（Long/Timestamp），如果存成了字符串，排序逻辑会完全不符合预期，也可能导致查询无结果
  • 核对routineKey的值是否完全匹配，有没有大小写错误、多余空格这类细节问题，Firestore的字符串匹配是精确匹配，一点差异都会查不到数据

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