如何通过JPA派生查询实现单参数匹配两个字段的OR查询？

安全阿岳

2026-6-23

解决方案：单个参数匹配多字段OR的JPA查询

方法名查询的局限性

Spring Data JPA的方法名推导规则中，每个查询条件对应一个独立参数，无法让单个参数同时匹配两个字段的OR逻辑。你期望的findOrderByDigitalRecipientAccountIdOrSoldToAccountId(Long accountId, Pageable pageable)方法名，框架无法自动推导——它会默认要求两个参数分别对应digitalRecipientAccountId和soldToAccountId，也就是你明确说不需要的双参数写法。

可行实现方式

方式1：使用@Query注解（推荐，简洁直接）

这是最直接的实现路径，通过JPQL定义查询逻辑，完美匹配你的调用需求：

@Repository
public interface OrderRepository extends JpaRepository<Order, Long> {

    @Query("SELECT o FROM Order o WHERE o.digitalRecipientAccountId = :accountId OR o.soldToAccountId = :accountId")
    Page<Order> findOrderByDigitalRecipientAccountIdOrSoldToAccountId(@Param("accountId") Long accountId, Pageable pageable);
}

传入单个accountId参数后，框架会自动处理分页，返回任一字段匹配的订单分页结果。

方式2：使用Specification（无@Query注解）

如果必须避免硬编码JPQL，可以通过Spring Data JPA的Specification接口动态构建查询：

让Repository继承JpaSpecificationExecutor：

@Repository
public interface OrderRepository extends JpaRepository<Order, Long>, JpaSpecificationExecutor<Order> {
}

调用时构建查询条件：

Long accountId = account.get().getId();
Specification<Order> spec = (root, query, criteriaBuilder) -> 
    criteriaBuilder.or(
        criteriaBuilder.equal(root.get("digitalRecipientAccountId"), accountId),
        criteriaBuilder.equal(root.get("soldToAccountId"), accountId)
    );

Page<Order> orders = orderRepository.findAll(spec, pageable);

这种方式不需要在Repository中定义额外方法，但调用代码会比@Query方式稍复杂。