PostgreSQL查询在PG Admin正常，Spring Boot+Hibernate报日期类型匹配错误

我之前也碰到过一模一样的问题——PG Admin里跑的SQL完全正常，一搬到Spring Boot的Hibernate项目里就报类型不匹配。其实核心原因很简单：PostgreSQL客户端会自动做隐式类型转换，但Hibernate不会帮你做这件事，再加上代码里的SQL写法如果不规范，就直接触发了这个错误。

先拆解下你的场景：PG Admin里第二条语句能运行，是因为客户端把字符串'2017-09-04'自动转换成了date类型和字段对比；但Hibernate执行原生SQL时，如果你直接把日期字符串拼进SQL、或者参数传递类型不对，数据库收到的就是纯字符串参数，和date字段对比自然就会报错。

下面给你几个可行的解决方案，按优先级排序：

1. 用参数绑定传递正确的日期类型（强烈推荐） #

绝对不要直接把日期字符串拼接进SQL里——既容易引发SQL注入，又会导致类型问题。用Spring Data JPA的参数绑定功能，直接传递LocalDate类型的参数，Hibernate会自动帮你处理类型转换：

原生SQL示例 #

@Repository
public interface RaportDasRepository extends JpaRepository<RaportDas, Long> {

    @Query(value = "SELECT * FROM raport_das WHERE dataZawarcia >= :startDate AND dataZawarcia <= :endDate AND status = :status", nativeQuery = true)
    List<RaportDas> findByDateRangeAndStatus(
        @Param("startDate") LocalDate startDate,
        @Param("endDate") LocalDate endDate,
        @Param("status") String status
    );
}

JPQL示例（更贴合ORM风格） #

如果你的实体类已经正确映射了数据库字段，用JPQL会更符合Hibernate的使用逻辑：

@Repository
public interface RaportDasRepository extends JpaRepository<RaportDas, Long> {

    @Query("SELECT r FROM RaportDas r WHERE r.dataZawarcia >= :startDate AND r.dataZawarcia <= :endDate AND r.status = :status")
    List<RaportDas> findByDateRangeAndStatus(
        @Param("startDate") LocalDate startDate,
        @Param("endDate") LocalDate endDate,
        @Param("status") String status
    );
}

调用的时候直接传入LocalDate.parse("2017-09-04")这类日期对象即可，完全不用自己拼字符串。

2. 检查实体类的字段映射是否正确 #

确保你的RaportDas实体类中，dataZawarcia字段的类型和数据库的date类型完全匹配：

@Entity
@Table(name = "raport_das")
public class RaportDas {

    // 其他字段...

    @Column(name = "dataZawarcia", columnDefinition = "date")
    private LocalDate dataZawarcia;

    // getter、setter...
}

这里用LocalDate对应数据库的date类型是最精准的，尽量避免用String或者Date（Date包含时间信息，容易引发额外的类型问题）。

3. 显式转换类型（临时方案，不推荐） #

如果因为特殊原因必须用字符串参数，那就在SQL里显式把两边都转换成date类型：

SELECT * FROM raport_das 
WHERE cast(dataZawarcia as date) >= cast(:startDate as date) 
AND cast(dataZawarcia as date) <= cast(:endDate as date) 
AND status = :status

注意：这种方式会让数据库无法使用dataZawarcia字段上的索引（如果存在的话），查询性能会明显下降，所以只适合临时救急。

总结一下，最稳妥的解决方式就是用参数绑定传递LocalDate类型，同时确保实体类字段映射正确，这样就能彻底解决类型不匹配的问题了。

内容的提问来源于stack exchange，提问作者łukasz dusza