参数值类型不匹配：LocalDate入参查询报java.util.Date类型不符错误

异常原因 #

1. 版本兼容性问题：早期Spring Data JPA（2.0版本之前）对Java 8引入的java.time.LocalDate等新日期类型支持不完善，默认会将参数解析为旧的java.util.Date类型，导致类型不匹配。
2. 自定义查询未做类型适配：手写@Query语句时，JPA无法自动识别LocalDate参数与数据库日期字段的对应关系，解析阶段仍期望旧日期类型。
3. 实体类字段映射缺失：若使用Hibernate作为JPA实现，未显式指定LocalDate字段的Hibernate类型，框架无法正确完成字段映射。

解决办法 #

1. 升级Spring Data JPA版本 #

直接升级到Spring Data JPA 2.0及以上版本（对应Spring Boot 2.0+），新版本原生支持Java 8日期时间API，无需额外配置即可自动处理LocalDate类型的参数映射。

2. 自定义查询中显式处理类型转换 #

在@Query语句中通过类型转换函数明确参数类型，示例：

@Query("SELECT e FROM #{#entityName} e WHERE e.date = CAST(:date AS date)")
List<DTO> findAllByDate(@Param("date") LocalDate date);

或者使用Hibernate的日期转换函数：

@Query("SELECT e FROM #{#entityName} e WHERE e.date = function('DATE', :date)")
List<DTO> findAllByDate(@Param("date") LocalDate date);

3. 配置实体类字段的Hibernate类型 #

如果无法升级版本，在实体类的LocalDate字段上添加@Type注解指定Hibernate类型：

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import org.hibernate.annotations.Type;
import java.time.LocalDate;

@Entity
public class YourEntity {
    @Id
    private Long id;
    
    @Column(name = "date")
    @Type(type = "org.hibernate.type.LocalDateType")
    private LocalDate date;
    
    // getter、setter方法
}

4. 使用Spring Data衍生查询方法 #

放弃自定义@Query，直接利用Spring Data的命名规则生成查询，框架会自动处理类型转换：

List<DTO> findByDate(LocalDate date);

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