Vert.x JDBC-Client 4.3.0为何与Oracle索引不兼容？

问题根源 #

Vert.x 4.x的JDBC-Client在元数据处理逻辑上和3.9.x版本有差异，新版本会自动校验索引有效性（即报错中的checkValidIndex操作），但Oracle 12c的JDBC驱动对CTX这类特殊全文索引的元数据支持不完善，导致抛出SQLFeatureNotSupportedException。好在这只是元数据校验阶段的报错，不影响实际业务SQL执行，所以功能仍能正常运行。

可行的解决办法 #

• 关闭元数据自动校验：在JDBC连接池配置中禁用元数据校验，避免触发不支持的操作。代码示例：

  JdbcPool pool = JdbcPool.pool(vertx, new JdbcConnectOptions()
    .setJdbcUrl("jdbc:oracle:thin:@//your-db-host:1521/your-sid")
    .setUser("your-username")
    .setPassword("your-password"),
    new PoolOptions().setMaxSize(10));
  // 禁用元数据校验
  pool.getDelegate().setMetadataChecks(false);
  

• 升级Oracle JDBC驱动：将ojdbc驱动升级至12c对应的最新版本（比如ojdbc8 12.2.0.1及以上），新版本驱动对CTX索引的元数据支持可能有优化，可减少这类报错。
• 过滤日志干扰：如果不想修改代码或驱动，可通过日志配置过滤该报错。以logback为例，在配置文件中添加：

  <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
    <evaluator>
      <expression>return message.contains("Unsupported feature: checkValidIndex");</expression>
    </evaluator>
    <onMatch>DENY</onMatch>
  </filter>
  

验证CTX索引是否正常工作 #

若担心索引被忽略，可通过执行计划确认：

EXPLAIN PLAN FOR SELECT * FROM your_table WHERE CONTAINS(your_column, 'test-keyword') > 0;
SELECT PLAN_TABLE_OUTPUT FROM TABLE(DBMS_XPLAN.DISPLAY());

如果执行计划中出现DOMAIN INDEX，说明CTX索引在正常被使用，并未被忽略。

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