Spring Data JDBC查询Oracle VARCHAR2字段返回null问题排查

问题背景 #

使用Spring Data JDBC连接Oracle 12c只读库，通过ORDER_ID（VARCHAR2类型，存储数字格式字符串如"123"）查询时返回空结果，但该记录确实存在，且纯JDBC执行相同SQL可正常获取结果。主键DELIVERY_TASK_ID（RAW类型）查询正常，实体类映射ORDER_ID也无问题（主键查询时能正确获取该字段值）。日志显示参数绑定为String类型（SQL type 12），已尝试TRIM、LIKE、回退Java/JDBC驱动版本均无效。

可能原因 #

1. Oracle隐式类型转换异常
   当VARCHAR2列存储数字格式字符串时，若驱动将String参数隐式转换为数字类型，Oracle会把列值也转为数字进行比较。这种转换可能因列中存在非数字格式的记录（即使当前查询的记录合法）导致索引失效，或因精度问题（如字符串"123"转数字后与列值转数字后的比较逻辑异常）。

2. Spring Data JDBC与纯JDBC的参数绑定差异
   尽管日志显示参数类型为VARCHAR，但ojdbc驱动在Spring Data JDBC的封装下，可能对数字格式的String参数做了特殊处理，导致与数据库端的VARCHAR2列比较不匹配，而纯JDBC直接调用setString的方式则无此问题。

3. 隐藏字符或字符集不匹配
   列中的ORDER_ID可能包含全角空格、不可见控制字符（如换行、制表符），或客户端与数据库字符集不一致，导致传入的"123"与存储值实际不相等。

解决建议 #

1. 强制字符串类型比较 #

修改Repository的查询SQL，显式确保参数与列值以字符串类型匹配，避免隐式转换：

@Query(value = "SELECT DELIVERY_TASK_ID FROM DELIVERY_TASK WHERE ORDER_ID = TO_CHAR(:orderId)")
List<DeliveryTask> findByOrderId(@Param("orderId") String orderId);

或通过拼接空字符串强制Oracle按字符串处理参数：

@Query(value = "SELECT DELIVERY_TASK_ID FROM DELIVERY_TASK WHERE ORDER_ID = :orderId || ''")
List<DeliveryTask> findByOrderId(@Param("orderId") String orderId);

2. 模拟纯JDBC逻辑排查 #

自定义JdbcTemplate查询，直接复用纯JDBC的参数绑定方式，验证是否能获取结果：

@Autowired
private JdbcTemplate jdbcTemplate;

public List<DeliveryTask> customFindByOrderId(String orderId) {
    return jdbcTemplate.query(
        "SELECT DELIVERY_TASK_ID FROM DELIVERY_TASK WHERE ORDER_ID = ?",
        new Object[]{orderId},
        (rs, rowNum) -> new DeliveryTask(rs.getString("DELIVERY_TASK_ID"), null)
    );
}

若此方法能查到结果，说明问题出在Spring Data JDBC的封装逻辑上，可进一步排查其参数绑定配置。

3. 检查列存储的实际内容 #

通过查询获取目标记录ORDER_ID的长度和十六进制值，对比传入参数的实际编码：

SELECT ORDER_ID, LENGTH(ORDER_ID), RAWTOHEX(UTL_I18N.STRING_TO_RAW(ORDER_ID, 'AL32UTF8')) 
FROM DELIVERY_TASK 
WHERE DELIVERY_TASK_ID = '你的测试主键值'

将结果与RAWTOHEX(UTL_I18N.STRING_TO_RAW('123', 'AL32UTF8'))对比，确认是否存在隐藏字符或编码差异。

4. 自定义参数绑定配置 #

若上述方法无效，可自定义Spring Data JDBC的JdbcConverter，显式指定String参数的绑定类型，确保驱动以VARCHAR类型传递参数，避免自动类型转换。

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