如何在JPA的Java @Entity类中表示integer ARRAY列定义

JPA规范本身并未原生支持数据库数组类型，不过作为主流JPA实现的Hibernate提供了两种可行的方案：

1. 利用Hibernate的原生扩展映射（推荐，无需手动写SQL定义） #

从Hibernate 5.4版本开始，你可以通过@JdbcTypeCode注解直接映射PostgreSQL的integer数组，无需指定columnDefinition：

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

    @Column(name = "scores")
    @JdbcTypeCode(SqlTypes.ARRAY)
    private Integer[] scores;

    // getter、setter方法
}

这里直接用Integer[]类型对应数据库的integer ARRAY列，Hibernate会自动处理类型转换。如果你的项目依赖Spring Data JPA，只要底层用的是Hibernate，这个方案同样适用。

2. 通过columnDefinition手动定义列类型 #

如果使用较旧版本的Hibernate，或者想要明确指定数据库列的定义，可以用@Column的columnDefinition属性直接写PostgreSQL的数组类型语法：

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

    @Column(name = "scores", columnDefinition = "integer ARRAY")
    private Integer[] scores;

    // getter、setter方法
}

这种方式完全贴合你提到的PostgreSQL官方文档中的列定义格式，确保数据库列类型和代码映射一致。

注意：如果要使用List<Integer>而非数组类型，不能直接映射为数据库数组列——此时@ElementCollection会将其映射为关联表，而非单个数组列。若要映射为数组列，建议使用Integer[]类型。

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