Oracle JDBC连接异常：如何配置服务名而非SID？

问题根源 #

你使用的旧版Oracle JDBC驱动（oracle.jdbc.driver.OracleDriver）对服务名的URL格式识别有特定要求，当前配置的host:port/servicename格式未被正确解析，被错误识别成了host:port:sid的格式，导致连接报错。

解决办法 #

方案1：修正JDBC URL格式（推荐） #

在URL的@符号后添加//，明确告知驱动这是服务名连接格式：

<property name="url">
    <value>jdbc:oracle:thin:@//myhost:myport/myservicename</value>
</property>

方案2：使用TNS描述符格式（兼容性最强） #

如果方案1不生效，改用完整的TNS连接描述符，这种写法可以适配几乎所有Oracle驱动版本：

<property name="url">
    <value>jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=myhost)(PORT=myport))(CONNECT_DATA=(SERVICE_NAME=myservicename)))</value>
</property>

额外优化：更新驱动类 #

旧的oracle.jdbc.driver.OracleDriver已被Oracle官方废弃，建议替换为新版驱动类，提升兼容性和稳定性：

<property name="driverClassName">
    <value>oracle.jdbc.OracleDriver</value>
</property>

修改完成后重启应用，驱动即可正确识别URL中的服务名，不再将其误判为SID，连接池就能正常创建连接了。

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