Spring Boot JPA邮箱模糊分页查询结果时有时无如何解决？

常见根因 #

• 大小写敏感问题：默认Containing关键字生成的查询是大小写敏感的，用户输入关键词大小写和数据库存储不一致时就会查询不到，匹配上的时候就有结果，直观表现为时好时坏。
• 入参未做预处理：如果传入的搜索关键词为null、前后带空格，或者分页/排序参数非法（比如页码小于1、排序字段在实体类中不存在），查询要么直接返回空，要么抛出异常被全局异常拦截器吞掉后返回空列表。
• 缓存/事务一致性问题：如果项目开启了JPA二级缓存或者查询缓存，数据更新后缓存未及时失效，会导致新写入的数据查询不到；事务隔离级别设置不合理也会出现未提交数据不可查的情况，表现为间歇性查询失效。

正确实现方案 #

1. 调整Repository查询逻辑，使用大小写不敏感匹配 #

推荐手动写JPQL查询避免JPA实现差异导致的逻辑不一致：

@Repository
public interface UserRepository extends JpaRepository<User, Long> { 
    @Query("SELECT u FROM User u WHERE LOWER(u.email) LIKE LOWER(CONCAT('%', :keyword, '%'))")
    Page<User> searchByEmailKeyword(@Param("keyword") String keyword, Pageable pageable);
}

也可以直接用Spring Data JPA自带的关键字：Page<User> findByEmailContainingIgnoreCase(String email, Pageable pageable);

2. Service层增加参数校验与预处理 #

对入参做合法性校验和清洗，避免非法参数导致查询失败：

public Page<User> findPaginatedEmail(int pageNo, int pageSize, String sortField, String sortDirection, String text) {
    // 搜索关键词清洗：空值处理+去除前后空格
    String keyword = Optional.ofNullable(text).map(String::trim).orElse("");
    // 分页参数合法性修正
    pageNo = Math.max(pageNo, 1);
    pageSize = Math.max(pageSize, 1);
    // 排序字段白名单校验，避免传入非法字段抛异常
    List<String> allowedSortFields = Arrays.asList("id", "email", "createTime", "updateTime");
    String validSortField = allowedSortFields.contains(sortField) ? sortField : "id";
    // 排序方向修正
    Sort.Direction direction = Sort.Direction.ASC.name().equalsIgnoreCase(sortDirection) ? Sort.Direction.ASC : Sort.Direction.DESC;
    Pageable pageable = PageRequest.of(pageNo - 1, pageSize, Sort.by(direction, validSortField));
    return userRepository.searchByEmailKeyword(keyword, pageable);
}

3. 排查辅助配置 #

开启JPA SQL打印配置，出现问题时可直接核对生成的SQL和传入参数，快速定位问题：

# application.properties配置
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=trace

如果是缓存导致的问题，可临时关闭二级缓存验证，确认问题后调整缓存失效策略即可。

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