Spring Boot 3+Hibernate 6.1迁移：自定义PostgreSQL方言适配问题

问题背景 #

从Spring Boot 2.7+Hibernate 5迁移至Spring Boot 3.0+Hibernate 6.1时，原自定义方言继承的PostgreSQL10Dialect已被移除，需改为基于PostgreSQLDialect实现，原代码如下：

public class PGDialect extends PostgreSQL10Dialect {
  public PGDialect() {
    super();
    registerHibernateType(Types.ARRAY, "text[]");
    registerColumnType(Types.ARRAY, "text[]");
  }
}

迁移方案 #

1. 替换父类并调整类型注册 #

Hibernate 6.1中已不再区分版本号后缀的PostgreSQL方言，统一使用org.hibernate.dialect.PostgreSQLDialect作为基础类。同时适配Hibernate 6的API变化，调整类型注册逻辑：

import org.hibernate.dialect.PostgreSQLDialect;
import org.hibernate.type.TextArrayType;
import java.sql.Types;

public class PGDialect extends PostgreSQLDialect {
    public PGDialect() {
        super();
        // 注册JDBC类型到数据库列类型的映射
        registerColumnType(Types.ARRAY, "text[]");
        // 注册JDBC类型到Hibernate类型的映射，指定具体的数组类型实现
        registerHibernateType(Types.ARRAY, "text[]", TextArrayType.class);
    }
}

2. 简化配置（可选） #

Hibernate 6对PostgreSQL数组类型的原生支持已大幅优化，如果你的实体类使用@Type(type = "text[]")或JPA标准的@Array注解，无需自定义方言，直接使用默认的PostgreSQLDialect即可完成类型映射。此时只需在配置文件中指定：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

3. 配置自定义方言（若保留） #

如果仍需使用自定义方言，确保在Spring Boot配置文件中指定完整类路径：

spring.jpa.properties.hibernate.dialect=com.yourpackage.PGDialect

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