Spring MongoDB：ProjectionOperation中DateDiff使用报错及用法咨询

1. 确认MongoDB版本兼容性 #

$dateDiff是MongoDB 5.0及以上版本才支持的聚合操作符，如果你的MongoDB服务器版本低于5.0，直接使用DateDiff会报错——因为该操作符在低版本中不存在。这种情况下，要么升级MongoDB服务器到5.0+，要么改用旧的日期差计算逻辑。

2. 检查Spring Data MongoDB版本 #

Spring Data MongoDB 3.3.x及以上版本才引入了对$dateDiff的支持，对应的驱动适配MongoDB 5.0特性。如果你的Spring Data MongoDB版本低于3.3.x，DateDiff类要么无法生成正确的$dateDiff表达式，要么根本不存在。请确保依赖版本符合要求，比如Maven配置：

<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-mongodb</artifactId>
    <version>3.3.0</version> <!-- 或更高版本 -->
</dependency>

3. DateDiff的正确使用方式 #

核心调用规则 #

• diffValueOf方法的第二个参数必须传入ChronoUnit枚举（而非字符串"DAYS"）
• 方法顺序对应$dateDiff的参数逻辑：diffValueOf(endDateField, unit)指定结束日期字段，toDateOf(startDateField)指定开始日期字段，最终计算endDate - startDate的差值

完整投影示例 #

结合你用DateFromString转换字符串日期的场景，完整代码如下：

import org.springframework.data.mongodb.core.aggregation.Aggregation;
import org.springframework.data.mongodb.core.aggregation.DateOperators;
import java.time.temporal.ChronoUnit;

// 构建投影操作
ProjectionOperation projection = Aggregation.project()
    // 将字符串类型的日期字段转为Date类型
    .and(DateOperators.DateFromString.fromString("$requiredDate")).as("requiredDate")
    .and(DateOperators.DateFromString.fromString("$currentDate")).as("currentDate")
    // 计算两个日期的天数差（currentDate - requiredDate）
    .and(DateOperators.DateDiff.diffValueOf("currentDate", ChronoUnit.DAYS)
         .toDateOf("requiredDate")).as("daysDiff");

旧版本兼容方案（MongoDB <5.0） #

如果无法升级MongoDB版本，可以通过$subtract计算毫秒差，再除以一天的毫秒数（86400000）得到天数差：

import org.springframework.data.mongodb.core.aggregation.Aggregation;
import org.springframework.data.mongodb.core.aggregation.DateOperators;
import org.springframework.data.mongodb.core.aggregation.AggregationExpression;
import org.bson.Document;
import java.util.Arrays;

ProjectionOperation projection = Aggregation.project()
    .and(DateOperators.DateFromString.fromString("$requiredDate")).as("requiredDate")
    .and(DateOperators.DateFromString.fromString("$currentDate")).as("currentDate")
    .and(AggregationExpression.from(context -> 
        new Document("$divide", Arrays.asList(
            new Document("$subtract", Arrays.asList("$currentDate", "$requiredDate")),
            86400000 // 一天的毫秒数
        ))
    )).as("daysDiff");

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