Spring Data JPA中如何用@Query构建动态WHERE子句？

@Query注解本身是用来定义静态JPQL/SQL的，没法直接在里面动态构建WHERE子句，但有几种可行的方案能实现你的多条件动态过滤需求，结合你的实体场景给出具体做法：

方案一：将@Query逻辑整合到JPA Specifications中 #

你之前混用@Query和Specifications无效，是因为两者不能直接配合。正确做法是把@Query里的特殊过滤逻辑写到Specification中，用Specifications统一处理所有动态条件。

步骤： #

1. 让Repository继承JpaSpecificationExecutor<Recipe>：

public interface RecipeRepository extends JpaRepository<Recipe, Long>, JpaSpecificationExecutor<Recipe> {
}

2. 构建包含所有过滤条件的Specification：
   比如实现title模糊匹配、HealthLabel过滤、食材名称过滤的逻辑：

public class RecipeSpecifications {
    public static Specification<Recipe> withFilters(String text, HealthLabel healthLabel, String ingredientName) {
        return (root, query, criteriaBuilder) -> {
            List<Predicate> predicates = new ArrayList<>();
            
            // 原@Query中的title模糊查询逻辑
            if (text != null && !text.isEmpty()) {
                predicates.add(criteriaBuilder.like(root.get("title"), "%" + text + "%"));
            }
            
            // HealthLabel过滤（排除默认值）
            if (healthLabel != null && healthLabel != HealthLabel.DEFAULT) {
                predicates.add(criteriaBuilder.equal(root.get("healthLabel"), healthLabel));
            }
            
            // 关联食材表的过滤逻辑
            if (ingredientName != null && !ingredientName.isEmpty()) {
                Join<Recipe, RecipeIngredient> recipeIngredientJoin = root.join("recipeIngredients");
                Join<RecipeIngredient, Ingredient> ingredientJoin = recipeIngredientJoin.join("ingredient");
                predicates.add(criteriaBuilder.like(ingredientJoin.get("name"), "%" + ingredientName + "%"));
            }
            
            return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
        };
    }
}

3. 调用时传入动态条件：

// 示例：查询title含"pasta"、健康标签为VEGETARIAN、含食材"tomato"的分页数据
Page<Recipe> recipes = recipeRepository.findAll(
    RecipeSpecifications.withFilters("pasta", HealthLabel.VEGETARIAN, "tomato"),
    PageRequest.of(0, 10)
);

方案二：用QueryDSL实现类型安全的动态查询 #

如果更偏好类型安全的查询语法，可以用QueryDSL实现动态条件拼接：

步骤： #

1. 引入QueryDSL依赖（Maven示例）：

<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-jpa</artifactId>
    <version>5.0.0</version>
</dependency>
<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-apt</artifactId>
    <version>5.0.0</version>
    <scope>provided</scope>
</dependency>

2. 让Repository继承QuerydslPredicateExecutor<Recipe>：

public interface RecipeRepository extends JpaRepository<Recipe, Long>, QuerydslPredicateExecutor<Recipe> {
}

3. 构建动态Predicate：

QRecipe recipe = QRecipe.recipe;
QRecipeIngredient recipeIngredient = QRecipeIngredient.recipeIngredient;
QIngredient ingredient = QIngredient.ingredient;

BooleanBuilder predicate = new BooleanBuilder();

// title模糊查询
if (text != null && !text.isEmpty()) {
    predicate.and(recipe.title.like("%" + text + "%"));
}

// HealthLabel过滤
if (healthLabel != null && healthLabel != HealthLabel.DEFAULT) {
    predicate.and(recipe.healthLabel.eq(healthLabel));
}

// 食材名称过滤
if (ingredientName != null && !ingredientName.isEmpty()) {
    predicate.and(recipe.recipeIngredients.any().ingredient.name.like("%" + ingredientName + "%"));
}

// 执行分页查询
Page<Recipe> recipes = recipeRepository.findAll(predicate, PageRequest.of(0, 10));

方案三：用SpEL表达式在@Query中实现简单动态逻辑（适合场景简单的情况） #

如果你的动态条件不多，可以用Spring SpEL表达式在@Query中动态拼接条件，但复杂逻辑会导致JPQL臃肿，维护性差：

@Query("SELECT r FROM Recipe r " +
       "WHERE (:text IS NULL OR r.title LIKE %:text%) " +
       "AND (:healthLabel IS NULL OR r.healthLabel = :healthLabel) " +
       "AND (:ingredientName IS NULL OR EXISTS (" +
       "    SELECT ri FROM RecipeIngredient ri " +
       "    JOIN ri.ingredient i " +
       "    WHERE ri.recipe = r AND i.name LIKE %:ingredientName%))")
Page<Recipe> findByFields(
    @Param("text") String text,
    @Param("healthLabel") HealthLabel healthLabel,
    @Param("ingredientName") String ingredientName,
    Pageable pageable
);

原理是当参数为null时，对应条件会被忽略（OR前半部分为true），从而实现动态过滤。

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