Spring Data JPA中如何定义含固定查询参数的查询方法？

算力阿峰

2026-6-21

问题解答

结论

你提到的findByCusNoAndIsValidOrderByCreateTimeDesc(String cusNo)方法不会自动应用isValid = 'Y'的过滤条件，反而会因参数数量不匹配报错——这个方法名对应的查询逻辑需要传入cusNo和isValid两个参数，而你只传了一个。

正确实现方式

如果希望仅通过cusNo作为参数，同时自动过滤isValid = 'Y'的记录，有以下几种可行方案：

方案1：保留自定义`@Query`方法（最直接）

你原本的@Query写法已经完全满足需求，只需要传入cusNo参数，且明确指定了isValid = 'Y'的过滤条件，不需要修改：

@Query("select c from Customer c where c.cusNo = :cusNo and c.isValid = 'Y' order by c.createTime desc")
List<Customer> getCustomerList(String cusNo);

方案2：用默认方法封装查询

先定义带两个参数的标准查询方法，再通过默认方法固定isValid = 'Y'，对外暴露仅需cusNo的方法：

// 内部使用的标准查询方法
List<Customer> findByCusNoAndIsValidOrderByCreateTimeDesc(String cusNo, String isValid);

// 对外暴露的方法，自动传入isValid='Y'
default List<Customer> findValidCustomersByCusNo(String cusNo) {
    return findByCusNoAndIsValidOrderByCreateTimeDesc(cusNo, "Y");
}

方案3：自定义命名的`@Query`方法（符合Spring Data命名风格）

如果想让方法名更贴合业务语义，可以自定义方法名，同时保留@Query的条件：

@Query("select c from Customer c where c.cusNo = :cusNo and c.isValid = 'Y' order by c.createTime desc")
List<Customer> findValidCustomersByCusNoOrderByCreateTimeDesc(String cusNo);