Spring Boot集成H2数组列的Hibernate映射异常问题咨询

问题根因说明 #

• H2 1.4.200版本的无类型ARRAY列本质以序列化二进制格式存储，无法直接与Java数组做类型映射，读取时会触发十六进制解析错误
• Hibernate 5.x系列默认未实现JDBC数组类型到Java数组的自动转换，会尝试将Java数组序列化为二进制字段存储，与H2 2.x的INTEGER ARRAY类型不匹配，触发类型转换错误
• 单独引入Hibernate 6.x依赖时未排除Spring Boot 2.7.0默认集成的Hibernate 5.x依赖，类路径存在重复版本的Hibernate类，导致entityManagerFactory初始化失败

方案一：保留Hibernate 5.6.8版本，无额外依赖实现映射 #

该方案不需要升级任何依赖，仅通过JPA注解配置即可完成适配：

1. 修正实体类配置，明确指定字段类型与列定义

@Entity
@Table(name = "Routes")
public class Route {
    @Id
    @GeneratedValue
    private int id;
    private String name;
    // 核心配置：指定列类型为H2整数数组
    @Column(columnDefinition = "INTEGER ARRAY[100] NOT NULL")
    private Integer[] stops;

    // 补充getter、setter方法
}

如果上述配置仍报类型转换错误，直接实现标准JPA的AttributeConverter接口做自定义转换即可：读取时将JDBC返回的java.sql.Array转为Integer[]，写入时通过H2 JDBC连接创建ARRAY对象传入。

2. 配置application.yml关闭Hibernate自动建表，避免覆盖schema.sql定义的表结构

spring:
  jpa:
    hibernate:
      ddl-auto: none
  sql:
    init:
      mode: always

3. 保持schema.sql、data.sql的H2 2.x兼容语法即可正常运行。

方案二：升级Hibernate 6.x版本（原生支持数组映射） #

Hibernate 6.x原生支持JDBC数组类型与Java数组的自动映射，不需要额外配置类型，仅需解决依赖冲突问题：

1. 修正pom.xml依赖，排除spring-boot-starter-data-jpa自带的低版本Hibernate，避免版本冲突

<dependencies>
    <!-- 其他依赖保持不变 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.hibernate</groupId>
                <artifactId>hibernate-core</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>2.1.212</version>
    </dependency>

    <!-- 手动引入Hibernate 6.x版本 -->
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-core</artifactId>
        <version>6.1.0.Final</version>
    </dependency>
</dependencies>

2. 简化实体类配置，Hibernate 6会自动完成Integer[]与INTEGER ARRAY类型的映射

@Entity
@Table(name = "Routes")
public class Route {
    @Id
    @GeneratedValue
    private int id;
    private String name;
    @Column(columnDefinition = "INTEGER ARRAY[100] NOT NULL")
    private Integer[] stops;

    // 补充getter、setter方法
}

3. 保持schema.sql、data.sql的H2 2.x语法，启动项目即可正常读写数组字段。

验证标准 #

启动后调用/route端点查询数据，可正常获取stops字段的数组内容，无类型转换异常。

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