Spring Boot连接Oracle数据库报错：Invalid Oracle URL specified

这个java.sql.SQLException: Invalid Oracle URL specified异常我碰到过好多次，本质就是你的Oracle数据库连接URL格式不对，或者配置里缺了必要参数。给你梳理几个最靠谱的排查和修复方向：

• 检查URL格式是否符合Oracle JDBC规范
  Oracle JDBC Thin驱动有两种常用的URL格式，别搞混了：

  • 推荐的服务名格式（适合12c及以上的CDB/PDB架构）：jdbc:oracle:thin:@//<主机地址>:<端口>/<服务名>
  • 旧版SID格式（仅适用于传统单实例数据库）：jdbc:oracle:thin:@<主机地址>:<端口>:<SID>
    举个实际例子，如果你的数据库主机是localhost，端口1521，PDB服务名是ORCLPDB1，正确的URL应该是：jdbc:oracle:thin:@//localhost:1521/ORCLPDB1
    常见坑点：漏写//、把服务名和SID搞反、端口号写错、主机地址填错。

• 核对Spring Boot配置文件的参数
  确保application.properties或application.yml里的数据源配置没有拼写错误：

  # application.properties 示例配置
  spring.datasource.url=jdbc:oracle:thin:@//localhost:1521/ORCLPDB1
  spring.datasource.username=your_db_username
  spring.datasource.password=your_db_password
  spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
  

  注意：如果用的是ojdbc11及以上版本，driver-class-name可以省略，Spring Boot会自动识别，但写上也没问题。排查时要注意URL里有没有多余空格、特殊字符，或者配置项拼写错误（比如把url写成uri）。

• 确保驱动版本和数据库版本兼容
  别用太老的驱动去连新版本的Oracle数据库，比如Oracle 19c/21c最好搭配ojdbc8或ojdbc11，否则可能出现URL解析失败的兼容性问题。Maven依赖示例：

  <dependency>
      <groupId>com.oracle.database.jdbc</groupId>
      <artifactId>ojdbc11</artifactId>
      <version>21.13.0.0</version>
  </dependency>
  

• 检查手动创建数据源的代码逻辑
  如果你是像报错里那样手动实例化OracleDataSource，要确保URL设置正确，别拼错：

  OracleDataSource dataSource = new OracleDataSource();
  // 这里的URL要严格符合规范
  dataSource.setURL("jdbc:oracle:thin:@//localhost:1521/ORCLPDB1");
  dataSource.setUser("your_db_username");
  dataSource.setPassword("your_db_password");
  Connection conn = dataSource.getConnection();
  

额外小提示：如果还是搞不定，先拿SQL Developer、Navicat这类工具测试数据库连接，确认主机、端口、服务名/SID、用户名密码都是有效的，再把这些参数原封不动复制到Spring Boot配置里，能快速排除数据库本身的连接问题。

内容的提问来源于stack exchange，提问作者S.A.Norton Stanley