如何配置Liquibase实现ZonedDateTime与LocalDateTime的PostgreSQL正确映射？

方案1：配置Liquibase Hibernate插件的全局类型映射 #

如果项目使用liquibase-hibernate5/liquibase-hibernate6插件（Spring项目默认依赖此插件实现实体与数据库的diff对比），可通过自定义配置文件指定全局类型映射规则：

1. 在src/main/resources下创建hibernate-types.properties文件，添加映射规则：

# 将ZonedDateTime映射为PostgreSQL的TIMESTAMP WITH TIME ZONE
java.time.ZonedDateTime=org.hibernate.type.ZonedDateTimeType
# 将LocalDateTime映射为PostgreSQL的TIMESTAMP WITHOUT TIME ZONE
java.time.LocalDateTime=org.hibernate.type.LocalDateTimeType

2. 在pom.xml的Liquibase插件配置中引入该文件：

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>你的Liquibase版本</version>
    <dependencies>
        <dependency>
            <groupId>org.liquibase.ext</groupId>
            <artifactId>liquibase-hibernate6</artifactId>
            <version>对应适配版本</version>
        </dependency>
        <!-- 需同时引入Hibernate核心、PostgreSQL驱动等依赖 -->
    </dependencies>
    <configuration>
        <!-- 其他Liquibase基础配置（如changeLogFile、数据库url等） -->
        <propertyFile>src/main/resources/hibernate-types.properties</propertyFile>
    </configuration>
</plugin>

方案2：实体类字段显式指定数据库类型 #

若无需全局配置，可直接在实体类字段上通过@Column注解指定对应数据库类型：

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import java.time.ZonedDateTime;
import java.time.LocalDateTime;

@Entity
public class YourEntity {
    // 强制映射为TIMESTAMP WITH TIME ZONE
    @Column(columnDefinition = "TIMESTAMP WITH TIME ZONE")
    private ZonedDateTime zonedTime;

    // 默认映射为TIMESTAMP WITHOUT TIME ZONE，无需额外配置
    private LocalDateTime localTime;

    // 其他字段与方法
}

这种方式适合单个实体的个性化类型需求。

方案3：自定义Liquibase类型转换器 #

若上述方案不生效，可自定义类型转换器类，实现Liquibase的TypeConverter接口来强制映射：

import liquibase.database.Database;
import liquibase.database.core.PostgresDatabase;
import liquibase.datatype.DataTypeInfo;
import liquibase.datatype.DatabaseDataType;
import liquibase.datatype.core.TimestampType;

@DataTypeInfo(name = "zoneddatetime", aliases = {"java.time.ZonedDateTime"}, minParameters = 0, maxParameters = 0, priority = DataTypeInfo.PRIORITY_DEFAULT)
public class ZonedDateTimeToTimestampWithTimeZone extends TimestampType {
    @Override
    public DatabaseDataType toDatabaseDataType(Database database) {
        if (database instanceof PostgresDatabase) {
            return new DatabaseDataType("TIMESTAMP WITH TIME ZONE");
        }
        return super.toDatabaseDataType(database);
    }
}

随后在Liquibase配置文件（如liquibase.properties）中注册该转换器：

customDatatypes=com.yourpackage.ZonedDateTimeToTimestampWithTimeZone

确保该类能被项目类路径加载。

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