如何解决JDBC与OCI版本冲突并通过服务名连接Oracle？

一、版本冲突问题解决 #

错误提示Incompatible version of libocijdbc[Jdbc:193000, Jdbc-OCI:1918000]明确说明：你使用的Oracle JDBC驱动版本（19.3.0.0）与本地OCI客户端版本（19.18.0.0）不兼容，两者版本必须严格匹配才能正常使用OCI驱动。以下是具体解决步骤：

1. 统一JDBC与OCI版本 #

• 确认JDBC版本：执行命令java -jar ojdbc<版本号>.jar -version（如java -jar ojdbc8.jar -version）查看当前JDBC驱动版本；Maven/Gradle项目可通过依赖树命令（mvn dependency:tree/gradle dependencies）确认。
• 匹配OCI客户端：下载与JDBC驱动完全同版本的Oracle OCI客户端，安装后配置环境变量：
  • Windows：将OCI客户端的bin目录添加到系统PATH
  • Linux/Unix：将OCI客户端的lib目录添加到LD_LIBRARY_PATH
• 验证加载路径：确保JVM优先加载目标版本的OCI库文件（如ocijdbc19.dll/libocijdbc.so），清理系统中其他版本的同名库文件。

2. 替换JDBC驱动适配现有OCI #

若不想更换OCI客户端，直接将项目中的JDBC驱动jar替换为与现有OCI客户端同版本的包，确保依赖中无多版本冲突。

二、服务名连接Oracle的可行方案 #

1. Thin驱动（无版本依赖，推荐） #

这是你当前正常使用的驱动，完整服务名连接格式如下：

<property name="url" value="jdbc:oracle:thin:@//<数据库主机>:<监听端口>/<服务名>"/>

示例：

<property name="url" value="jdbc:oracle:thin:@//10.0.0.5:1521/orcl.prod.com"/>

若使用tnsnames.ora配置的服务别名，需设置TNS_ADMIN环境变量指向该文件目录，URL写法为：

<property name="url" value="jdbc:oracle:thin:@<TNS别名>"/>

2. OCI驱动（解决版本冲突后使用） #

版本匹配完成后，服务名连接的正确URL格式：

<property name="url" value="jdbc:oracle:oci:@//<数据库主机>:<监听端口>/<服务名>"/>

或使用TNS别名：

<property name="url" value="jdbc:oracle:oci:@<TNS别名>"/>

同样需配置TNS_ADMIN环境变量指向tnsnames.ora目录。

3. 服务名确认方式 #

可通过以下方式获取数据库服务名：

• 执行数据库命令：SELECT value FROM v$parameter WHERE name = 'service_names';
• 查看监听状态：执行lsnrctl status，在Services Summary中查看服务名。

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