如何在执行前获取Oracle数据库Prepared Statement对象的实际SQL查询语句？

以下方案按实现成本从低到高排序，可根据你的实际场景选择：

方案1：利用Oracle JDBC驱动内置能力（最便捷） #

Oracle官方ojdbc驱动原生提供了获取已拼接参数SQL的能力，不需要额外引入依赖：

• 适用ojdbc版本：ojdbc8 12.2.0.1及以上版本
• 实现方式：将你的PreparedStatement实例强转为oracle.jdbc.OraclePreparedStatement，直接调用toString()方法即可拿到参数已填充的完整SQL。
• 代码示例：

import oracle.jdbc.OraclePreparedStatement;

// 此处pstmt为你已经完成所有setXXX参数赋值的PreparedStatement对象
if (pstmt.isWrapperFor(OraclePreparedStatement.class)) {
    OraclePreparedStatement oracleStmt = pstmt.unwrap(OraclePreparedStatement.class);
    String executableSql = oracleStmt.toString();
    // 部分旧版本输出会带类名前缀，可通过字符串截取去掉无关内容
    executableSql = executableSql.substring(executableSql.indexOf(": ") + 2);
    System.out.println(executableSql);
}

• 注意：如果用的是ojdbc6等低版本驱动，没有内置自动拼接能力，可以调用getOriginalSql()获取带占位符的原语句，配合getParameterMetaData()获取参数类型，遍历你存储的参数值自行替换占位符即可。

方案2：日志配置实现（无需修改业务代码） #

仅调试场景下可用，不需要修改任何业务逻辑：

• 在你的项目日志配置文件中，将oracle.jdbc包的日志级别调整为DEBUG（logback/log4j）或者FINE（java util logging），驱动会自动输出所有执行的SQL语句和绑定的参数值，直接从日志中提取即可。

方案3：自行封装PreparedStatement（兼容性最好） #

如果需要跨驱动版本兼容，或者要对SQL做自定义处理，可以自己封装实现：

• 定义一个PreparedStatement包装类，实现JDBC的PreparedStatement接口，内部持有原生PreparedStatement实例，同时用有序集合存储所有setXXX方法传入的参数值和参数类型。
• 需要获取完整SQL时，按顺序遍历存储的参数，替换原SQL中的?占位符即可，替换时注意不同参数类型的转义规则：
  • 字符串/日期类型：需要用单引号包裹，特殊字符要做转义处理
  • 数字类型：直接替换不需要额外符号
  • 日期类型可按Oracle语法格式化为TO_DATE('2024-05-20 14:30:00', 'YYYY-MM-DD HH24:MI:SS')格式

小技巧：替换占位符时从右往左执行，可避免参数值内包含?导致的替换错位问题。

方案4：数据库端查询（仅执行后可用于校验） #

如果可以接受SQL执行后再获取，可通过Oracle系统视图查询：

• 执行SQL后，查询V$SQL视图，用原占位符SQL作为过滤条件，即可查到数据库端实际执行的完整SQL，还可关联V$SQL_BIND_CAPTURE视图获取绑定参数值，适合上线后校验SQL正确性、排查性能问题使用。

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