Spring Boot多列模糊查询：派生查询还是@Query更合适？

嘿，这个问题问到点子上了！咱们结合你的场景来聊聊两种方案的适用场景：

1. 少量字段（比如3个）：派生查询完全可行 #

对于你提到的firstName、lastName、middleName这三个字段，用Spring Data的派生查询是非常顺手的，代码简洁还不用自己写SQL。比如你可以这么定义方法：

Page<User> findByFirstNameContainingOrLastNameContainingOrMiddleNameContaining(String keyword, Pageable pageable);

Spring Data会自动帮你生成对应的SQL，实现任意一个字段包含%loe%的模糊匹配，分页也能直接支持。这种方式的优点就是零SQL编写成本，可读性也不错，适合字段数量少的场景。

2. 多字段场景（比如9个）：派生查询就不太合适了 #

如果要匹配9个字段，派生查询的方法名会变得异常冗长——想象一下findByField1ContainingOrField2ContainingOrField3ContainingOr...OrField9Containing这种写法，不仅看着头疼，写的时候容易写错，后续维护也麻烦（比如要加字段、改字段名，都得改超长的方法名）。

这时候**@Query注解自定义查询**才是更优解，它能让你的代码逻辑更清晰，方法名也简洁。举个JPQL的例子：

@Query("SELECT u FROM User u WHERE " +
       "u.firstName LIKE %:keyword% OR " +
       "u.lastName LIKE %:keyword% OR " +
       "u.middleName LIKE %:keyword% OR " +
       "u.field4 LIKE %:keyword% OR " +
       "u.field5 LIKE %:keyword% OR " +
       "u.field6 LIKE %:keyword% OR " +
       "u.field7 LIKE %:keyword% OR " +
       "u.field8 LIKE %:keyword% OR " +
       "u.field9 LIKE %:keyword%")
Page<User> findByAnyFieldContaining(@Param("keyword") String keyword, Pageable pageable);

如果需要不区分大小写的匹配，还可以用LOWER()和CONCAT()来优化：

@Query("SELECT u FROM User u WHERE " +
       "LOWER(u.firstName) LIKE LOWER(CONCAT('%', :keyword, '%')) OR " +
       "LOWER(u.lastName) LIKE LOWER(CONCAT('%', :keyword, '%')) OR " +
       "...")
Page<User> findByAnyFieldContainingIgnoreCase(@Param("keyword") String keyword, Pageable pageable);

这种方式的好处是逻辑一目了然，方法名简短，后续修改字段只需要调整JPQL语句即可，维护成本低很多。

总结一下选择标准 #

• 字段数量≤4个：派生查询是首选，快速实现，代码干净。
• 字段数量≥5个（尤其是9个这种多字段场景）：果断用@Query自定义查询，避免冗长的方法名，提升代码可维护性。

如果你的字段数量还会动态变化，那可以进一步了解Specification或者QueryDSL来构建动态查询，但对于固定9个字段的场景，@Query完全够用啦。

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