Spring JPA多类别查询返回无结果问题求助

1. 参数传递问题 #

• 检查categoryOne和categoryTwo的大小写匹配：MySQL默认大小写不敏感（取决于配置），但JPA实体的category字段若未配置大小写不敏感规则（如@Column(columnDefinition = "VARCHAR(255) COLLATE utf8mb4_general_ci")），可能因大小写差异导致匹配失败。
• 排查参数是否含多余空格：若传入参数带首尾空格（如"Science "），而数据库存储值无空格，会导致匹配失效，可在查询前对参数做trim处理，或在SQL中用TRIM(category) = ?。

2. 分页参数配置问题 #

• 校验Pageable对象的参数：若page值超出实际总页数，或排序字段不存在，可能导致异常结果；另外检查是否配置了spring.data.jpa.repositories.pageable.count-queries=false，该配置会禁用单独的count查询，可能导致getTotalElements返回错误值。
• 确认分页逻辑是否干扰count查询：部分复杂场景下，自动生成的count语句可能存在逻辑错误，可手动执行日志中输出的count SQL，验证返回值是否正确。

3. 实体映射与全局过滤问题 #

• 检查category字段的映射正确性：确保实体字段名与数据库列名一致，或通过@Column(name = "xxx")指定正确列名，避免因列名不匹配导致查询无结果。
• 排查实体类的全局过滤注解：若实体类添加了@Where(clause = "is_deleted = 0")这类过滤条件，而测试数据的对应字段不符合（如is_deleted=1），JPA查询会自动带上过滤条件，导致无结果，而直接执行MySQL SQL时未包含该条件，因此有返回值。

4. 缓存与事务一致性问题 #

• 检查二级缓存干扰：若实体启用了二级缓存，之前的空结果可能被缓存，可在查询方法添加@Cacheable(false)或清空缓存后重试。
• 确认事务隔离级别影响：若查询在未提交的事务内执行，或与写入事务的隔离级别冲突，可能无法读取到最新数据，可验证查询是否在独立事务中执行。

5. 原生SQL查询的细节问题 #

• 校验参数绑定顺序：使用原生查询时，确保?1、?2的顺序与方法参数顺序一致，避免因参数错位导致查询无匹配数据。
• 检查分页语句的兼容性：Spring JPA会为原生SQL自动添加分页语句（如LIMIT），若原生SQL已包含分页逻辑或复杂子查询，可能导致count查询失效，需手动调整SQL结构。

6. 日志辅助排查 #

开启Hibernate SQL日志，查看实际执行的SQL与绑定参数：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql=TRACE

将日志中输出的完整SQL（含参数值）直接在MySQL中执行，若执行有结果但JPA返回空，需排查参数类型匹配问题（如数据库字段为CHAR，JPA传递VARCHAR导致匹配失败）。

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