Spring Boot中GraphQL过滤器无法兼容LocalDateTime的问题

我通过自定义过滤器对象将GraphQL的DataFetchingEnvironment参数转换为JPA查询，核心代码如下：

// env 是 DataFetchingEnvironment
FilterExpression filterExpression = builder.args(env.getArguments()).build();
Specification<BaseModel> specification = filterExpression.getExpression(ExpressionFormat.JPA);

执行时JPA抛出类型不匹配异常，根源是过滤器库将日期参数转换为了java.util.Date格式（如Wed Jan 18 00:00:00 UTC 2023），但实体类对应SQL DateTime列的字段类型为java.time.LocalDateTime，报错信息如下：

Parameter value [Wed Jan 18 00:00:00 UTC 2023] did not match expected type [java.time.LocalDateTime (n/a)]; nested exception is java.lang.IllegalArgumentException: Parameter value [Wed Jan 18 00:00:00 UTC 2023] did not match expected type [java.time.LocalDateTime (n/a)]

补充细节：SQL列类型为DateTime，Hibernate无特殊配置，完整报错栈：

Caused by: java.lang.IllegalArgumentException: Parameter value [Wed Jan 18 00:00:00 UTC 2023] did not match expected type [java.time.LocalDateTime (n/a)]
    at org.hibernate.query.spi.QueryParameterBindingValidator.validate(QueryParameterBindingValidator.java:54) ~[hibernate-core-5.6.12.Final.jar:5.6.12.Final]
    ... 53 common frames omitted

排查发现问题出在FilterExpression.newFilterExpressionBuilder().args(env.getArguments()).build()的日期处理逻辑，目前临时方案是跳过DateTime过滤器、手动添加Specification，但希望直接适配过滤器构建器解决问题。

1. 预处理GraphQL参数，转换日期类型 #

在将参数传入过滤器构建器前，手动把Date类型的日期参数转换为LocalDateTime：

Map<String, Object> args = new HashMap<>(env.getArguments());
// 遍历参数，处理所有日期类型的参数
for (Map.Entry<String, Object> entry : args.entrySet()) {
    Object value = entry.getValue();
    if (value instanceof Date) {
        // 转换为UTC时区的LocalDateTime，可根据业务调整时区
        LocalDateTime localDateTime = ((Date) value).toInstant()
                .atZone(ZoneId.of("UTC"))
                .toLocalDateTime();
        entry.setValue(localDateTime);
    }
}
FilterExpression filterExpression = builder.args(args).build();
Specification<BaseModel> specification = filterExpression.getExpression(ExpressionFormat.JPA);

2. 扩展过滤器库的类型转换器 #

如果使用的过滤器库支持自定义类型转换，可以注册Date到LocalDateTime的转换器，让构建器自动处理类型转换：

// 假设过滤器构建器提供registerConverter方法
builder.registerConverter(Date.class, LocalDateTime.class, date -> 
    date.toInstant().atZone(ZoneId.of("UTC")).toLocalDateTime()
);
FilterExpression filterExpression = builder.args(env.getArguments()).build();
Specification<BaseModel> specification = filterExpression.getExpression(ExpressionFormat.JPA);

3. 调整实体类字段类型（备选） #

若业务允许，可将实体类中对应DateTime列的LocalDateTime字段改为java.util.Date，但此方案不符合Java 8+时间API的最佳实践，仅作为临时妥协方案。

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