Spring中如何使用java.sql.Array？Hibernate映射异常求助

问题原因 #

Hibernate无法直接识别java.sql.Array这类JDBC层面的类型，因此抛出MappingException——它不知道该如何把这个类型映射到数据库的数组字段上。

解决方案 #

1. 替换字段类型 #

将java.sql.Array替换为标准Java集合类型（比如数组是整数类型就用List<Integer>，字符串数组就用List<String>），这是Hibernate能够直接处理的类型。

2. 添加映射注解 #

为字段添加@Column指定数据库列的数组类型，同时用@Type指定Hibernate的PostgreSQL数组处理器（需要确保项目依赖包含Hibernate的PostgreSQL类型支持库）。

3. 清理不必要的注解 #

实体类不需要加@Component，JPA实体由Spring Data JPA管理，@Component会导致Spring额外创建Bean实例，可能引发冲突。

修改后的实体类代码 #

@Entity
public class Theater {
    
    @Id
    private int theaterId;
    
    @Column(columnDefinition = "integer[]") // 对应PostgreSQL的整数数组类型
    @Type(type = "org.hibernate.type.PostgresArrayType") // 指定Hibernate的数组类型处理器
    private List<Integer> theaterNumbers;
    
    private String theaterLoc;
    
    // JPA要求实体必须有无参构造函数，必须添加
    public Theater() {
        super();
    }
    
    public Theater(List<Integer> theaterNumbers, String theaterLoc) {
        super();
        this.theaterNumbers = theaterNumbers;
        this.theaterLoc = theaterLoc;
    }

    // getter和setter方法
    public int getTheaterId() {
        return theaterId;
    }

    public void setTheaterId(int theaterId) {
        this.theaterId = theaterId;
    }

    public List<Integer> getTheaterNumbers() {
        return theaterNumbers;
    }

    public void setTheaterNumbers(List<Integer> theaterNumbers) {
        this.theaterNumbers = theaterNumbers;
    }

    public String getTheaterLoc() {
        return theaterLoc;
    }

    public void setTheaterLoc(String theaterLoc) {
        this.theaterLoc = theaterLoc;
    }
}

依赖说明 #

如果是Maven项目，需要在pom.xml中添加Hibernate PostgreSQL类型支持依赖（根据你的Hibernate版本选择对应版本）：

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>2.19.0</version>
</dependency>

如果是Gradle项目：

implementation 'com.vladmihalcea:hibernate-types-52:2.19.0'

额外注意 #

• 确保PostgreSQL数据库中theater表的theater_numbers字段类型与注解中指定的一致（比如用text[]对应字符串数组）。
• 必须保留无参构造函数，否则会触发JPA的映射错误。

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