Oracle 11g中使用CrudRepository操作定长CHAR列的问题

我正在开发基于Spring Boot的项目，需要查询Oracle 11g数据库，执行类似select * from item where item_code = 'abc'的简单查询。但ITEM_CODE是**CHAR(10)**类型的定长列，CrudRepository的派生查询全部失效，仅like查询能正常返回结果。

代码示例（测试时传入的itemCode均为AB1234） #

// 派生查询：返回0条结果
public Item findByIdItemCode(String itemCode);

// 硬编码参数的自定义查询：返回1条结果
@Query("select r from Item r where r.id.itemCode = 'AB1234'") 
public Item findcustomfix();

// 带参数的自定义查询：返回0条结果
@Query("select r from Item r where r.id.itemCode = :itemCode")
public Item findcustom(@Param("itemCode") String itemCode);

// Like查询：返回1条结果（但无法区分AB123和AB1234，不能长期使用）
@Query("select r from Item r where r.id.itemCode like %:itemCode%")
public Item findcustomLike(@Param("itemCode") String itemCode);

配置文件（application.properties） #

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.OracleDialect

实体类ID字段定义 #

// class itemKey
@Column(name="ITEM_CODE", columnDefinition="CHAR", length = 10)
// 尝试过@Column(name="ITEM_CODE", columnDefinition="CHAR(10)")，同样无效
private String itemCode;

我已经给字段添加了长度定义，但Hibernate依然没有生成适配定长列的SQL语句（预期应为where ITEM_CODE = 'AB1234 '）。Like查询存在歧义，不能作为长期解决方案，有没有合规的解决办法？

更新：日志信息 #

Hibernate: select i1_0.com, i1_0.item_code from stock i1_0 where i1_0.item_code=?
org.hibernate.orm.jdbc.bind: binding parameter [1] as [ **VARCHAR** ] - [AB1234]

跟踪堆栈发现，参数的VARCHAR类型由org.hibernate.type.descriptor.jdbc.VarcharJdbcType.getJdbcTypeCode()返回，调用栈路径为JdbcParameterBindings ==> jdbcValueBinder。我猜测需要强制参数按CHAR类型而非VARCHAR绑定，但尚未找到具体实现方式。

解决方法 #

• 自定义Hibernate类型强制绑定CHAR参数
  自定义OracleCharType覆盖默认Varchar绑定逻辑，让Hibernate将字符串参数按CHAR类型绑定：

  import org.hibernate.type.AbstractSingleColumnStandardBasicType;
  import org.hibernate.type.descriptor.jdbc.CharJdbcType;
  import org.hibernate.type.descriptor.java.StringJavaType;
  
  public class OracleCharType extends AbstractSingleColumnStandardBasicType<String> {
      public static final OracleCharType INSTANCE = new OracleCharType();
  
      public OracleCharType() {
          super(CharJdbcType.INSTANCE, StringJavaType.INSTANCE);
      }
  
      @Override
      public String getName() {
          return "oracle-char";
      }
  }
  

  然后在实体类字段上指定该自定义类型：

  @Column(name="ITEM_CODE", columnDefinition="CHAR(10)")
  @Type(type = "com.yourpackage.OracleCharType")
  private String itemCode;
  

• 手动补全参数空格
  若不想自定义类型，可在传入参数前手动将字符串补全到10位长度：

  public Item findByIdItemCode(String itemCode) {
      // 左对齐补空格至10位
      String paddedCode = String.format("%-10s", itemCode);
      return findcustom(paddedCode);
  }
  

  注意：需确保业务层统一处理，避免遗漏补空格。

• 自定义Hibernate方言调整类型映射
  自定义Oracle方言，修改字符串类型的JDBC绑定逻辑：

  import org.hibernate.dialect.OracleDialect;
  import org.hibernate.type.descriptor.jdbc.CharJdbcType;
  import org.hibernate.type.descriptor.jdbc.JdbcType;
  import org.hibernate.type.descriptor.java.StringJavaType;
  
  public class CustomOracleDialect extends OracleDialect {
      @Override
      public JdbcType getJdbcTypeForJavaType(org.hibernate.type.descriptor.java.JavaType<?> javaType) {
          if (javaType instanceof StringJavaType) {
              return CharJdbcType.INSTANCE;
          }
          return super.getJdbcTypeForJavaType(javaType);
      }
  }
  

  替换配置文件中的默认方言：

  spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomOracleDialect
  

• 原生SQL显式转换参数类型
  使用原生SQL查询，通过cast将参数转为CHAR(10)类型：

  @Query(value = "select * from item where item_code = cast(:itemCode as char(10))", nativeQuery = true)
  public Item findcustomNative(@Param("itemCode") String itemCode);
  

内容的提问来源于stack exchange，提问作者Jimmy Chi Kin Chau