Jpa中String类型主键操作Entity无返回结果问题排查

String类型主键本身不会导致这个查询无结果的问题，以下是几个常见的排查方向：

• 大小写不匹配：
  部分数据库（如PostgreSQL、开启区分大小写排序规则的MySQL）对字符串查询是大小写敏感的。检查传入的id与数据库ALPHA_ID字段的实际值是否大小写完全一致，比如数据库存的是"USER001"，而代码传入的是"user001"就会匹配失败。可以直接用数据库客户端执行打印出来的SQL语句，验证是否能查到数据。

• 隐藏字符/空格问题：
  传入的id或数据库字段值可能包含空格、制表符、换行等不可见字符，肉眼无法分辨。可以：

  • 在代码中打印id的长度，和数据库中对应字段值的长度对比；
  • 临时修改原生查询，加入trim处理：

    @Query(value="select a.* from people a where trim(a.ALPHA_ID) = trim(:id)", nativeQuery = true)
    Optional<People> findByAlphaId(@Param("id") String id);
    

• 数据库字段类型不匹配：
  确认数据库中ALPHA_ID字段的类型是否与实体类的String对应，比如数据库字段是CHAR(15)，而传入的id长度不足15时，数据库会自动补空格，导致与传入的无空格字符串不匹配；或者字段类型是TEXT，某些特殊情况下绑定参数会有隐性问题。

• JPA缓存干扰：
  JPA的一级缓存（Session级）会缓存之前的查询结果，如果之前执行过相同id的查询且返回空，后续查询可能直接从缓存取结果。可以尝试：

  • 重启应用后重新测试；
  • 在查询前调用EntityManager.clear()清空缓存（如果能获取到EntityManager的话）。

• 参数绑定隐性问题：
  虽然打印的SQL语句看起来正确，但参数绑定可能存在异常。可以临时将id硬编码到原生查询中（比如where a.ALPHA_ID = 'TEST001'），验证是否能查到数据，排除参数传递过程中的问题。

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