Spring Boot 3.x升级后Hibernate时间类型不匹配语义异常求助

问题背景 #

原Spring Boot 2.x中使用PostgreSQL查询语句：

UPDATE TABLE SET lastDateTime = CURRENT_TIMESTAMP WHERE x = :y

集成测试用H2数据库，Liquibase配置：

databaseChangeLog:
  - changeSet:
      id: 10
      author: auth01
      changes:
        - createTable:
            tableName: TABLE
            columns:
              - column:
                  name: last_date_Time
                  type: TIMESTAMP WITH TIME ZONE

升级至Spring Boot 3.1.3（依赖：hibernate-core-6.2.7.Final、postgresql-42.5.4、h2-2.2.224等）后，出现错误：

org.hibernate.query.SemanticException: The assignment expression type [java.sql.Timestamp] did not match the assignment path type [java.time.OffsetDateTime] for the path [alias_1617001542.lastDateTime]

尝试修改Liquibase字段类型为TIMESTAMP、DATETIME、TIMESTAMPZ均无效。

原因分析 #

Spring Boot 3.x搭配的Hibernate 6.x对日期时间类型映射更严格：

• PostgreSQL中TIMESTAMP WITH TIME ZONE映射为OffsetDateTime
• H2默认环境下CURRENT_TIMESTAMP返回java.sql.Timestamp（无时区信息），与实体类映射的OffsetDateTime类型不匹配

解决建议 #

1. 调整查询语句，强制转换时间类型 #

将查询语句中的CURRENT_TIMESTAMP转换为带时区的类型，确保与实体类映射类型一致：

UPDATE TABLE SET lastDateTime = CAST(CURRENT_TIMESTAMP AS TIMESTAMP WITH TIME ZONE) WHERE x = :y

该写法在PostgreSQL和H2中均能正确解析为带时区的时间值，匹配OffsetDateTime类型。

2. 配置H2数据库兼容PostgreSQL行为 #

修改H2的JDBC URL，添加PostgreSQL兼容模式及时区配置，让CURRENT_TIMESTAMP返回带时区的时间：

spring.datasource.url=jdbc:h2:mem:testdb;MODE=PostgreSQL;TIMEZONE=UTC;DATABASE_TO_LOWER=TRUE

• MODE=PostgreSQL：启用PostgreSQL兼容模式，H2会模拟PostgreSQL的函数行为，CURRENT_TIMESTAMP将返回带时区的时间
• TIMEZONE=UTC：统一时区配置，避免时区差异导致的类型问题

3. 确保实体类字段映射正确 #

检查实体类中lastDateTime字段的类型及注解，明确映射为带时区的类型：

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import java.time.OffsetDateTime;

@Entity
public class YourEntity {
    @Id
    private Long x;
    
    @Column(name = "last_date_time", columnDefinition = "TIMESTAMP WITH TIME ZONE")
    private OffsetDateTime lastDateTime;
    
    // getter、setter
}

Hibernate 6.x默认将TIMESTAMP WITH TIME ZONE映射为OffsetDateTime，确保实体类字段类型与之对应，避免类型不匹配。

4. 统一Liquibase字段配置（可选） #

若需要针对不同数据库做更精细的类型配置，可在Liquibase中通过dbms属性区分：

databaseChangeLog:
  - changeSet:
      id: 10
      author: auth01
      changes:
        - createTable:
            tableName: TABLE
            columns:
              - column:
                  name: last_date_time
                  type: TIMESTAMP WITH TIME ZONE
                  dbms: postgresql,h2

确保PostgreSQL和H2使用一致的字段类型，避免环境差异。

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