使用JDBC Thin长URL连接Oracle 19c时Hibernate Reactive报错求解

使用Hibernate Reactive连接Oracle 19c时，短格式JDBC URL（jdbc:oracle:thin:@localhost:1521/ORCLCDB）可正常运行，但使用带DESCRIPTION的长格式TNS-style URL时，会触发java.lang.StringIndexOutOfBoundsException（异常信息：begin 0, end -1, length 108）。

原代码示例 #

public Mutiny.SessionFactory sessionFactory() {
  org.hibernate.cfg.Configuration configuration = constructConfiguration();
  StandardServiceRegistryBuilder builder = new ReactiveServiceRegistryBuilder().applySettings( configuration.getProperties() );
  StandardServiceRegistry registry = builder.build();
  return configuration.buildSessionFactory( registry ).unwrap( Mutiny.SessionFactory.class );
}

private org.hibernate.cfg.Configuration constructConfiguration() {
  org.hibernate.cfg.Configuration configuration = new org.hibernate.cfg.Configuration();

  entityTypes().forEach(configuration::addAnnotatedClass);

  // set DB info
  configuration.setProperty(Settings.DRIVER, "oracle.jdbc.driver.OracleDriver");
  // 可正常运行的短格式URL
  configuration.setProperty(Settings.URL,"jdbc:oracle:thin:@localhost:1521/ORCLCDB");
  // 触发异常的长格式URL
  // configuration.setProperty(Settings.URL,"jdbc:oracle:thin:@(DESCRIPTION=(ENABLE=BROKEN)(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SID=ORCLCDB)))");
  configuration.setProperty(Settings.USER, "user");
  configuration.setProperty(Settings.PASS, "1234");

  return configuration;
}

private Collection<Class<?>> entityTypes() {
  List<Class<?>> list = new ArrayList<>();
  list.add(TestEntity.class);
  return list;
}

问题根源 #

1. 驱动类不匹配：你使用的是传统JDBC驱动oracle.jdbc.driver.OracleDriver，但Hibernate Reactive需要适配Reactive上下文的Oracle专用驱动oracle.jdbc.reactive.OracleReactiveDriver，传统驱动的URL解析逻辑无法兼容Reactive框架的处理流程。
2. URL解析逻辑bug：旧版本Hibernate Reactive对Oracle长格式TNS-style URL的解析存在缺陷，它默认按照短格式URL的规则（拆分@后的冒号、斜杠）处理，长格式URL中没有这类分隔符，导致解析时触发索引越界。

解决方案 #

方案1：替换驱动+使用Easy Connect Plus格式传递参数

如果需要设置ENABLE=BROKEN这类参数，无需使用长TNS格式，改用Oracle的Easy Connect Plus格式即可，同时修正驱动类：

private org.hibernate.cfg.Configuration constructConfiguration() {
  org.hibernate.cfg.Configuration configuration = new org.hibernate.cfg.Configuration();

  entityTypes().forEach(configuration::addAnnotatedClass);

  // 使用Oracle Reactive驱动
  configuration.setProperty(Settings.DRIVER, "oracle.jdbc.reactive.OracleReactiveDriver");
  // Easy Connect Plus格式：将额外参数追加到URL末尾
  configuration.setProperty(Settings.URL,"jdbc:oracle:thin:@//localhost:1521/ORCLCDB?ENABLE=BROKEN");
  configuration.setProperty(Settings.USER, "user");
  configuration.setProperty(Settings.PASS, "1234");

  return configuration;
}

方案2：升级Hibernate Reactive版本并保留长格式URL

若必须使用长TNS格式URL：

• 升级Hibernate Reactive到6.x及以上稳定版（该版本已修复长格式URL解析bug）
• 替换驱动类为oracle.jdbc.reactive.OracleReactiveDriver
• 长格式URL可直接使用，无需修改：

configuration.setProperty(Settings.URL,"jdbc:oracle:thin:@(DESCRIPTION=(ENABLE=BROKEN)(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SID=ORCLCDB)))");

验证要点 #

• 确认项目依赖中包含Oracle Reactive驱动（需从Maven Central或Oracle官方仓库获取）
• 确保Hibernate Reactive版本与Oracle Reactive驱动版本兼容

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