RavenDB中DateTimeOffset类型在WhereBetween查询中的边界问题解析

问题背景

在使用RavenDB 6.2.2版本时，开发者发现当使用WhereBetween方法对DateTimeOffset类型字段进行范围查询时，出现了边界条件不包含的问题。具体表现为：当查询条件中包含午夜时间(00:00:00)的DateTimeOffset值时，相关记录会被意外过滤掉，而在6.0.100版本中则表现正常。

问题复现

考虑以下数据模型：

public class Model
{
    public DateTimeOffset CreatedAt { get; set; }
}

当存储一个创建时间为2025-01-21 09:00:00 UTC的记录后，执行以下查询：

var from = new DateTimeOffset(2025, 01, 21, 00, 00, 00, TimeSpan.Zero);
DateTimeOffset? to = null;
var query = session.Advanced.AsyncDocumentQuery<Model, ModelIndex>();
query.WhereBetween(x => x.CreatedAt, from, to);

在6.2.2版本中，这个查询会返回空结果集，而6.0.100版本则能正确返回记录。

技术分析

这个问题主要与RavenDB 6.2.2中引入的Corax搜索引擎有关。Corax在处理DateTimeOffset类型的边界条件时，对包含时间部分的日期值处理存在差异：

1. 当使用完整时间戳格式(如'2025-01-21T00:00:00.0000000Z')时，边界条件不包含
2. 当使用纯日期格式(如'2025-01-21')时，边界条件包含

这与SQL中BETWEEN操作符通常的包含性逻辑不一致，也导致了版本间的行为差异。

解决方案

RavenDB团队已经确认这是一个需要修复的问题。在等待官方修复的同时，开发者可以采用以下替代方案：

1. 使用显式的范围查询替代BETWEEN：

query.WhereGreaterThanOrEqual(x => x.CreatedAt, from);
if(to != null)
    query.WhereLessThanOrEqual(x => x.CreatedAt, to.Value);

2. 使用纯日期格式而非完整时间戳格式进行查询

3. 在查询中设置exact参数为true（虽然文档说明这是用于大小写敏感比较，但实际测试中会影响日期比较行为）

最佳实践建议

1. 对于日期范围查询，建议明确使用>=和<=操作符而非BETWEEN，以获得更可预测的行为
2. 在升级RavenDB版本时，应特别注意日期/时间相关查询的测试验证
3. 考虑在应用层统一日期比较逻辑，避免直接依赖数据库引擎的特定行为

总结

DateTimeOffset类型在范围查询中的边界处理是一个需要特别注意的问题。开发者应当了解不同版本间的行为差异，并根据实际需求选择合适的查询方式。RavenDB团队已将该问题列入修复计划，预计在后续版本中会提供更一致的行为。