JpaRepository查询MySQL字符串字段为null但ID正常的问题排查

核心原因：原生SQL字段映射不匹配 #

使用原生SQL查询时，JPA不会自动将数据库下划线命名的字段（如order_number）转换为实体类的驼峰命名属性（orderNumber）。主键id因字段名与属性名完全一致，能正常映射；而orderNumber因字段名不匹配，无法完成赋值，最终返回null。

验证与解决方案 #

1. 确认数据库字段名：检查数据库表中对应字段是否为order_number（而非orderNumber），这是最常见的触发场景。
2. 显式指定字段别名：修改原生SQL，将数据库字段名通过别名映射为实体类属性名：

@Query(value = "SELECT id, order_number AS orderNumber, account FROM `Order` WHERE account=?", nativeQuery = true)
public List<OrderBean> findOrderByAccount(String account);

3. 改用JPQL查询：利用JPA的自动映射能力，避免原生SQL的字段匹配问题：

@Query("SELECT o FROM OrderBean o WHERE o.account = ?1")
public List<OrderBean> findOrderByAccount(String account);

4. 添加字段映射注解：在实体类属性上明确指定数据库字段名，确保映射关系：

@Column(name = "order_number")
private String orderNumber;

其他排查方向 #

• 检查实体类的getOrderNumber()/setOrderNumber()方法是否存在拼写错误，比如误写为getOrdernumber()。
• 统一表名大小写：实体类@Table指定的是Order，DAO原生SQL中是order，部分大小写敏感的数据库（如PostgreSQL）可能引发表查询错误（不过从id能正常返回来看，该可能性较低）。

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