JPA查询问题：参数为Set属性成员时无法返回实体的解决办法

你的查询之所以无法返回结果，核心原因是JPA的JPQL对IN操作的解析逻辑和你用AttributeConverter存储的实际数据格式不匹配：

• 实体类中allowedUserStatuses是Set<String>，但通过转换器后，数据库里存储的是逗号分隔的单个字符串（比如"ACTIVE,INACTIVE"）。
• 你写的JPQL语句?1 IN ng.allowedUserStatuses，JPA会把它解析成“检查参数是否在实体的集合属性中”，但实际执行SQL时，它会尝试将参数和数据库中存储的整个字符串做对比，而不是拆分后匹配，自然找不到符合条件的数据。

根据你使用的数据库类型，有几种可靠的实现方式：

1. 使用数据库原生字符串函数（推荐） #

不同数据库提供了专门处理逗号分隔字符串的函数，直接在JPQL中调用这些函数即可实现需求：

针对MySQL/MariaDB #

使用FIND_IN_SET函数，它会检查指定值是否在逗号分隔的字符串中：

@Query("SELECT ng FROM #{#entityName} ng WHERE FIND_IN_SET(?1, ng.allowedUserStatuses) > 0")
List<NoticeGroupEntity> findByAllowedUserStatus(String userStatus);

针对PostgreSQL #

使用STRING_TO_ARRAY将字符串转成数组，再用ANY匹配：

@Query("SELECT ng FROM #{#entityName} ng WHERE ?1 = ANY(STRING_TO_ARRAY(ng.allowedUserStatuses, ','))")
List<NoticeGroupEntity> findByAllowedUserStatus(String userStatus);

通用数据库兼容方案（用LIKE避免部分匹配） #

如果需要跨数据库兼容，可以用CONCAT拼接逗号来避免部分匹配（比如防止"ACT"错误匹配到"ACTIVE"）：

@Query("SELECT ng FROM #{#entityName} ng WHERE CONCAT(',', ng.allowedUserStatuses, ',') LIKE CONCAT(',', ?1, ',')")
List<NoticeGroupEntity> findByAllowedUserStatus(String userStatus);

2. 使用Spring Data JPA的Specification/Criteria API #

如果需要更灵活的动态查询，可以用Specification来构建查询条件，调用数据库函数：

public static Specification<NoticeGroupEntity> hasAllowedUserStatus(String userStatus) {
    return (root, query, criteriaBuilder) -> {
        // 以MySQL为例，调用FIND_IN_SET函数
        Expression<Integer> findInSet = criteriaBuilder.function(
            "FIND_IN_SET",
            Integer.class,
            criteriaBuilder.literal(userStatus),
            root.get("allowedUserStatuses")
        );
        return criteriaBuilder.greaterThan(findInSet, 0);
    };
}

// 调用方式
List<NoticeGroupEntity> result = noticeGroupRepository.findAll(hasAllowedUserStatus("ACTIVE"));

3. 进阶：改用Hibernate自定义类型（替代AttributeConverter） #

如果你使用Hibernate作为JPA实现，可以改用@Type注解和自定义类型，让Hibernate直接处理集合到字符串的映射，这样JPQL的IN操作就能正常工作：

// 自定义类型实现（可参考Hibernate的StringArrayType或自行实现Set类型映射）
@Column(name = "allowed_user_statuses")
@Type(type = "com.yourpackage.StringSetType")
private Set<String> allowedUserStatuses;

这种方式下，你原来的JPQL查询就能直接生效，但需要额外实现Hibernate的自定义类型，适合长期维护的项目。

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