Spring Data JPA查询@ElementCollection字段报类型不匹配错误如何解决

问题原因 #

你写的JPQL查询存在两处问题：

1. 类型匹配错误：t.tags本身是List<String>集合类型，使用t.tags in (:tags)语法时，JPA会判定逻辑为「判断集合t.tags是否属于你传入的参数集合」，此时预期传入的参数应该是List<List<String>>类型，而你实际传的是List<String>，遍历参数时单个字符串和预期的集合类型不匹配，就抛出了类型不匹配异常。
2. 逻辑不符合需求：你需要的是实体标签列表包含传入的所有标签，而in语法即使修改对类型，也只能实现「实体标签完全等于传入列表中的某一个」的逻辑，满足不了包含所有的要求。

解决方案 #

方案1：JPQL动态拼接查询（跨数据库兼容） #

使用JPA的MEMBER OF语法判断单个标签是否属于实体的标签集合，标签数量不固定的话可以搭配Specification动态拼接条件：
首先让Repository继承JpaSpecificationExecutor接口：

public interface TopicRepository extends JpaRepository<Topic, Long>, JpaSpecificationExecutor<Topic> {
}

然后构造动态查询逻辑：

public List<Topic> findAllByContainingAllTags(List<String> tags) {
    return topicRepository.findAll((root, query, cb) -> {
        List<Predicate> predicates = new ArrayList<>();
        for (String tag : tags) {
            // 逐个判断标签是否属于实体的tags集合
            predicates.add(cb.isMember(tag, root.get("tags")));
        }
        // 所有标签条件同时满足才返回
        return cb.and(predicates.toArray(new Predicate[0]));
    });
}

方案2：原生SQL查询（性能更优） #

@ElementCollection默认会生成名为实体名_字段名的关联表（这里是topic_tags），关联字段为topic_id，标签字段为tags，可以写原生查询实现需求：

@Query(value = "SELECT t.* FROM topic t " +
        "JOIN topic_tags tt ON t.id = tt.topic_id " +
        "WHERE tt.tags IN (:tags) " +
        "GROUP BY t.id " +
        // 匹配到的不同标签数量等于传入标签总数，说明包含所有传入标签
        "HAVING COUNT(DISTINCT tt.tags) = :tagCount",
        nativeQuery = true)
List<Topic> findAllByContainingAllTags(@Param("tags") List<String> tags, @Param("tagCount") Integer tagCount);

调用时传入标签列表和列表长度即可：

List<String> tags = Arrays.asList("web", "mobile");
List<Topic> topics = topicRepository.findAllByContainingAllTags(tags, tags.size());

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