Spring Data JPA多对多关联下构造Specification实现分类商品查询

针对Product与Category多对多关联、查询指定分类ID集合下所属商品的需求，基于CriteriaBuilder构造Specification的具体方案如下： #

完整实现代码 #

import jakarta.persistence.criteria.Join;
import jakarta.persistence.criteria.JoinType;
import org.springframework.data.jpa.domain.Specification;
import java.util.List;

public class ProductSpecification {

    public static Specification<Product> searchProductInCategory(List<Integer> categoryIdList) {
        return (root, query, criteriaBuilder) -> {
            // 空参数兜底：分类ID列表为空时返回永假条件，避免无意义全表查询
            if (categoryIdList == null || categoryIdList.isEmpty()) {
                return criteriaBuilder.disjunction();
            }
            // 开启结果去重，避免多分类匹配时返回重复商品记录
            query.distinct(true);
            // 建立Product到Category的内连接，JPA自动根据实体配置关联中间表product_category
            Join<Product, Category> categoryRel = root.join("categories", JoinType.INNER);
            // 构造分类ID匹配条件
            return categoryRel.get("categoryId").in(categoryIdList);
        };
    }
}

核心逻辑说明 #

• 空值兜底：传入分类ID列表为空时，通过criteriaBuilder.disjunction()生成永假条件，直接返回空结果集，避免无参场景下扫描全表。
• 关联配置：root.join("categories", JoinType.INNER)会自动识别实体类上@ManyToMany和@JoinTable配置的关联关系，自动关联中间表product_category完成连表，不需要手动编写中间表的关联SQL。

  注意：join方法的第一个参数必须和Product实体中分类集合的属性名完全一致（即你定义的List<Category> categories），get方法传入的categoryId必须和Category实体的主键属性名完全一致，否则会抛出属性未找到的运行时异常。

• 去重处理：通过query.distinct(true)开启结果去重，解决一个商品同时归属多个传入分类时，内连接返回重复商品记录的问题。
• 条件匹配：通过连表对象获取分类表主键，调用in方法匹配传入的分类ID集合，生成最终的WHERE过滤条件。

调用说明 #

你当前定义的ProductRepo中自定义的searchProduct方法无需额外编写，JpaSpecificationExecutor接口已经默认提供了findAll(Specification<T> spec)方法，直接注入仓储对象调用即可：

// 业务层调用示例
List<Integer> targetCategoryIds = List.of(1, 3, 5);
List<Product> result = productRepo.findAll(
    ProductSpecification.searchProductInCategory(targetCategoryIds)
);

内容的提问来源于stack exchange，提问作者P.Hennry