Android Studio按DatePicker日期筛选Firestore RecyclerView无结果问题

1. 已通过Logcat完成索引配置
2. 我使用的date格式输出如下：

2021-08-20 15:25:34.888 30176-30176/com.kasthu.prkeng D/TAG: Date is: Fri Aug 20 05:30:00 GMT+05:30 2021

我所用的Firestore中存储的Timestamp为UTC格式，当前date为GMT+05:30时区格式，需要针对该时区差异给出适配建议。
当前我使用FirestoreRecyclerAdapter实现列表加载，简化代码如下：

FirestoreRecyclerOptions<model> options = new FirestoreRecyclerOptions.Builder<model>() 
.setQuery(df.orderBy("FullName", Query.Direction.ASCENDING) 
.whereEqualTo("TimeIn", date), model.class)
.build(); 
adapter = new fsattadapter(options); 
review.setAdapter(adapter);

出现的问题：只要在查询语句中加入whereEqualTo("TimeIn", date)条件，RecyclerView就不会展示任何内容，麻烦排查原因并给出解决方案。

核心原因 #

查询无返回通常由三类问题导致：

• 精度不匹配：Firestore的Timestamp精度到纳秒，Java Date对象精度仅到毫秒，哪怕时间点完全一致，纳秒部分的差异也会导致等值匹配失败
• 时间点不匹配：Firestore的Timestamp本质存储的是UTC时区的时间戳，如果你写入数据时没有把本地时间转换为对应UTC时间点存入，或者查询时传入的Date对象代表的UTC时间点和存储的不一致，自然匹配不到任何文档
• 索引缺失：即使你确认配置了索引，也要注意包含排序字段FullName和过滤字段TimeIn的组合索引是否正确配置，缺字段的索引无法支撑该组合查询

解决方案 #

方案一：范围查询替代等值查询（优先推荐） #

既可以规避精度误差，也能兼容小范围的时区偏移问题，适配绝大多数业务场景：

// 构造查询时间范围：以要查询的时间点为起点，向后覆盖你能接受的误差范围，比如1分钟
Calendar cal = Calendar.getInstance();
// 设置你要查询的本地时间
cal.set(2021, Calendar.AUGUST, 20, 5, 30, 0);
Date startTime = cal.getTime();
// 结束时间为起始时间加1分钟
cal.add(Calendar.MINUTE, 1);
Date endTime = cal.getTime();

// 替换查询条件为范围过滤
FirestoreRecyclerOptions<model> options = new FirestoreRecyclerOptions.Builder<model>()
        .setQuery(df.orderBy("FullName", Query.Direction.ASCENDING)
                .whereGreaterThanOrEqualTo("TimeIn", startTime)
                .whereLessThan("TimeIn", endTime), model.class)
        .build();
adapter = new fsattadapter(options);
review.setAdapter(adapter);

方案二：统一时区逻辑实现等值匹配 #

如果业务要求必须精确匹配到具体时间点，需要统一写入和查询的时区逻辑：

1. 写入Firestore时，先把本地时间转换为对应的UTC时间戳，再封装为Date/Timestamp对象写入
2. 查询时，用完全相同的时区转换逻辑把要匹配的本地时间转换为对应UTC时间点的Date对象，再传入whereEqualTo条件

方案三：长期优化建议 #

后续业务开发中，建议所有时间在存储和查询时都统一用UTC时间戳，前端展示时再根据用户所在时区转换为本地时间，从根源避免时区差异导致的各类问题。

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