Spring Data JPA查询集合类型字段使用Containing关键字报错如何解决

错误根因 #

报错的核心原因是JPA默认未识别appointmentTypeIds字段为集合属性：你当前仅为该字段添加了@Column注解，Hibernate会将其判定为普通单值属性，而Containing关键字用于集合包含查询时，要求字段被明确识别为集合类型，因此生成查询时抛出了unknown collection expression type异常。

解决方案 #

根据你的存储方案选择对应实现方式：

方案1：使用JPA标准集合存储（推荐，兼容性最强）

这是JPA规范原生支持的集合存储方式，会生成单独的关联表存储集合元素，无需依赖数据库原生数组能力：

1. 修改Communication实体类的字段注解：

@Getter
@Setter
@Entity
@Table(name = "communication")
public class Communication{
    @Id
    @Column("id")
    private Long id;

    @Column("name")
    private String name;

    // 新增以下注解替换原来的@Column
    @ElementCollection
    @CollectionTable(name = "communication_appt_type_ref", joinColumns = @JoinColumn(name = "communication_id"))
    @Column(name = "appointment_type_id")
    private List<Integer> appointmentTypeIds;
}

2. 你原来定义的Repository方法可直接正常运行：

List<Communication> findByAppointmentTypeIdsContaining(Integer targetId);

方案2：使用数据库原生数组存储

如果你希望将集合直接存储在communication表的appointment_type_ids数组字段中（例如使用PostgreSQL的INT[]类型），按如下方式修改：

1. 实体类添加数组类型映射注解：

低版本Hibernate需先引入hibernate-types工具依赖

@Getter
@Setter
@Entity
@Table(name = "communication")
public class Communication{
    @Id
    @Column("id")
    private Long id;

    @Column("name")
    private String name;

    // 替换原来的@Column注解
    @Type(type = "io.hypersistence.utils.hibernate.type.array.IntArrayType")
    @Column(name = "appointment_type_ids", columnDefinition = "INT[]")
    private List<Integer> appointmentTypeIds;
}

2. Repository手写原生查询实现包含匹配：

@Query(value = "SELECT * FROM communication WHERE :targetId = ANY(appointment_type_ids)", nativeQuery = true)
List<Communication> findByAppointmentTypeIdsContaining(@Param("targetId") Integer targetId);

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