如何在JPA/Hibernate中查询被@CreatedDate/@LastModifiedDate标注的LocalDateTime字段

按照以下优先级逐一排查验证即可解决问题： #

1. 验证审计字段基础配置 #

• 项目配置类/启动类必须添加@EnableJpaAuditing注解，否则审计字段不会自动填充，查询无结果不是语句问题，是字段根本未存值
• 实体类的updateDate字段必须添加@LastModifiedDate注解，业务代码中不要手动为该字段赋值，避免覆盖审计自动生成的值
• 不要为Java 8+时间类型（LocalDateTime/LocalDate等）添加@Temporal注解，该注解仅用于Date/Calendar类型，加了会导致Hibernate类型映射错误

2. 解决时区不一致问题 #

大部分查询无结果的核心原因是应用、JDBC、数据库三者时区不一致，导致传入的查询参数和数据库存储的时间存在时区差：

• 统一应用、数据库的时区，推荐全局使用UTC或者东8区
• 在项目配置文件中添加JPA时区配置，保证JDBC层读写时间时区统一：

  # properties格式
  spring.jpa.properties.hibernate.jdbc.time_zone=Asia/Shanghai
  

  # yaml格式
  spring:
    jpa:
      properties:
        hibernate:
          jdbc:
            time_zone: Asia/Shanghai
  

• 最优方案是将审计字段类型改为Instant，以时间戳形式存储，完全避过时区问题，查询时传入对应Instant类型参数即可

3. 验证SQL执行与参数绑定 #

开启SQL和参数打印，确认实际执行的查询语句、绑定参数符合预期：
在配置文件中添加日志配置：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=trace

执行查询后对比控制台输出的条件参数值和数据库实际存储的updateDate值，确认是否存在满足条件的数据。 #

4. 其他场景排查 #

• 若使用逻辑删除（如MyBatis-Plus逻辑删除、Hibernate@Where全局过滤），确认满足时间条件的实体未被逻辑删除，或临时关闭过滤验证查询结果
• 若使用QueryDSL，确认Q类为最新生成的，实体新增字段后未重新生成Q类会导致字段映射错误，执行mvn clean install/gradle build重新生成Q类即可
• 确认查询参数类型和字段类型一致，避免出现字段为LocalDate但传入LocalDateTime的类型不匹配问题

内容的提问来源于stack exchange，提问作者Kim Young Han