SpringBoot3与Hibernate6迁移启动报错：数组类型匹配异常求助

错误原因 #

该错误源于Hibernate 6对数组类型的处理逻辑变更，而hibernate-types-60提供的StringArrayType未被正确注册或识别，导致Hibernate构建SessionFactory时，无法将数据库数组类型与Java数组类型完成正确映射。

解决方案 #

1. 修正实体类字段注解 #

确保实体类中数组字段通过@Type显式指定自定义类型，示例代码：

import com.vladmihalcea.hibernate.type.array.StringArrayType;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import org.hibernate.annotations.Type;

@Entity
public class ExampleEntity {
    @Id
    private Long id;

    @Column(name = "tags", columnDefinition = "text[]")
    @Type(StringArrayType.class) // 必须指定该自定义类型
    private String[] tags;

    // 其他字段、getter/setter方法
}

2. 全局注册自定义类型（可选） #

若不想为每个数组字段添加@Type注解，可通过配置全局注册类型贡献者：

• 在application.properties中添加配置：

  spring.jpa.properties.hibernate.type_contributors=com.vladmihalcea.hibernate.type.util.CustomTypeContributor
  

• 或使用Java配置类实现：

  import org.springframework.boot.autoconfigure.orm.jpa.HibernatePropertiesCustomizer;
  import org.springframework.context.annotation.Bean;
  import org.springframework.context.annotation.Configuration;
  
  @Configuration
  public class HibernateTypeConfig {
      @Bean
      public HibernatePropertiesCustomizer hibernatePropertiesCustomizer() {
          return properties -> properties.put(
              "hibernate.type_contributors",
              "com.vladmihalcea.hibernate.type.util.CustomTypeContributor"
          );
      }
  }
  

3. 修复依赖版本冲突 #

移除手动指定的hibernate-core依赖，让SpringBoot自动管理Hibernate版本，避免版本不兼容问题：

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-60</artifactId>
    <version>2.22.0</version> <!-- 使用最新兼容版本 -->
</dependency>

SpringBoot 3.x默认集成的Hibernate 6版本与hibernate-types-60最新版本兼容，手动指定hibernate-core易引发版本冲突。

4. 替换数组为集合类型（备选方案） #

若上述方法仍无法解决问题，可将Java数组类型替换为List<String>，搭配ListStringArrayType使用：

import com.vladmihalcea.hibernate.type.array.ListStringArrayType;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import org.hibernate.annotations.Type;

import java.util.List;

@Entity
public class ExampleEntity {
    @Id
    private Long id;

    @Column(name = "tags", columnDefinition = "text[]")
    @Type(ListStringArrayType.class)
    private List<String> tags;

    // 其他字段、getter/setter方法
}

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