Spring Data JPA：如何组合多OR条件并实现括号逻辑

你的问题核心是JPA方法命名规则的优先级限制：默认情况下，OR的优先级低于AND，所以findByAppnameOrAppnameAndStatus会被解析成appname=?1 OR (appname=?2 AND status=?3)，和预期逻辑不符。以下是几种可行的解决方案：

1. 使用@Query注解自定义查询 #

直接编写JPQL语句精准控制条件优先级，这是最直接的方式：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.CrudRepository;
import java.util.List;

public interface EmailRepository extends CrudRepository<Email, Long> {
    // 位置参数写法
    @Query("SELECT e FROM Email e WHERE (e.appname = ?1 OR e.appname = ?2) AND e.status = ?3")
    List<Email> findByAppnamesAndStatus(String appName1, String appName2, String status);

    // 命名参数写法（可读性更高）
    // @Query("SELECT e FROM Email e WHERE (e.appname = :appName1 OR e.appname = :appName2) AND e.status = :status")
    // List<Email> findByAppnamesAndStatus(@Param("appName1") String appName1, @Param("appName2") String appName2, @Param("status") String status);
}

2. 用In关键字简化逻辑 #

你的需求是匹配两个特定appname值，完全可以用In替代OR，生成的SQL逻辑和预期等价，且无需处理括号：

List<Email> findByAppnameInAndStatus(List<String> appNames, String status);

调用时传入参数：

List<String> targetApps = Arrays.asList("facebook", "gmail");
List<Email> result = emailRepository.findByAppnameInAndStatus(targetApps, "Pending");

生成的SQL为：

select from abc.email e where e.appname in ('facebook','gmail') and e.status='Pending'

3. 使用Specification构建动态查询 #

如果需要更灵活的动态查询场景，可以用Specification构建带优先级的条件：

import org.springframework.data.jpa.domain.Specification;
import javax.persistence.criteria.Predicate;
import java.util.ArrayList;
import java.util.List;

public class EmailSpecifications {
    public static Specification<Email> withAppnamesAndStatus(List<String> appNames, String status) {
        return (root, query, criteriaBuilder) -> {
            List<Predicate> predicates = new ArrayList<>();
            // 构建appname的多值匹配条件
            predicates.add(root.get("appname").in(appNames));
            // 构建status匹配条件
            predicates.add(criteriaBuilder.equal(root.get("status"), status));
            // 用AND组合所有条件
            return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
        };
    }
}

Repository需继承JpaSpecificationExecutor：

public interface EmailRepository extends CrudRepository<Email, Long>, JpaSpecificationExecutor<Email> {
}

调用示例：

List<String> targetApps = Arrays.asList("facebook", "gmail");
List<Email> result = emailRepository.findAll(EmailSpecifications.withAppnamesAndStatus(targetApps, "Pending"));

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