Spring Boot连接服务器Oracle数据库报ORA-01017错误求助

全新搭建的Spring Boot 2.7.0项目连接服务端Oracle数据库时抛出两类异常：

• 核心连接错误：ORA-01017: invalid username/password; logon denied（用户名/密码无效，登录被拒）
• 嵌套误导错误：Unable to detect database type（无法检测数据库类型）
  使用第三方SQL客户端配置相同连接参数可正常登录数据库，当前项目配置如下：
  application.properties配置：

server.port=8080
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
spring.datasource.url=jdbc:oracle:thin:@100.73.35.145:1521/pdborcl
spring.datasource.username=DP1MT1_FAWAPPSHEL
spring.datasource.password=welcome1
spring.sql.init.platform=oracle
spring.batch.jdbc.initialize-schema=always

pom.xml核心依赖为spring-boot-starter-batch、ojdbc8 21.1.0.0、spring-boot-starter-data-jdbc。

1. 先消除嵌套异常的干扰，暴露真实错误 #

Spring Boot 2.7.0版本存在逻辑缺陷：当数据源首次连接失败时，Spring Batch自动初始化表结构的逻辑无法从失败的连接中识别数据库类型，会直接抛出Unable to detect database type异常，掩盖最开始的连接错误。
你虽然配置了spring.sql.init.platform=oracle，但Spring Batch的初始化逻辑不会读取这个参数，需要在配置文件中追加显式指定：

# 跳过数据库类型自动检测，直接指定为Oracle
spring.batch.jdbc.platform=oracle

添加该配置后重启项目，嵌套的类型检测错误会消失，控制台会输出真实的连接失败原因，避免排查方向被误导。

2. 排查账号密码解析错误 #

ORA-01017最常见的触发原因是配置值解析异常，而非真的账号密码错误：

• 逐字符核对spring.datasource.username、spring.datasource.password的值，确认没有多余的前后空格、全角字符，大小写和SQL客户端登录时完全一致（Oracle 12c及以上版本默认密码大小写敏感）
• 如果密码包含@、:、/、\等特殊字符，properties配置文件中直接书写会被JDBC驱动误判为连接串分隔符，需要对特殊字符做URL转义，或者将密码包裹在单引号中
• 临时验证：将测试用户的密码修改为纯小写字母+数字的无特殊字符值，替换配置后重启，验证是否能连通，快速排除特殊字符解析问题

3. 校验JDBC连接串格式 #

你当前使用的连接串jdbc:oracle:thin:@100.73.35.145:1521/pdborcl是服务名连接格式，需要确认：

• 服务端的pdborcl是可插拔数据库（PDB）的服务名，而非SID。如果是SID连接，需要将斜杠替换为冒号，格式为jdbc:oracle:thin:@100.73.35.145:1521:pdborcl
• 应用部署所在服务器的IP在数据库白名单内，可正常访问1521端口，没有被防火墙拦截
• ojdbc驱动版本和数据库版本匹配：当前使用的ojdbc8 21.1.0.0支持Oracle 11g、12c、19c、21c版本，如果数据库是10g及更早版本，需要降级ojdbc驱动

4. 排查用户状态与权限问题 #

• 登录SQL客户端执行以下语句，确认用户没有被锁定、密码未过期：

  -- 解锁用户
  ALTER USER DP1MT1_FAWAPPSHEL ACCOUNT UNLOCK;
  -- 重置密码（和配置中保持一致）
  ALTER USER DP1MT1_FAWAPPSHEL IDENTIFIED BY welcome1;
  

• 确认连接串指向的是用户所属的PDB服务，而非CDB根容器：普通业务用户默认创建在PDB下，直接连接CDB根容器会报权限不足或用户名密码错误。

5. 排除初始化逻辑干扰验证基础连通性 #

可以临时注释掉自动初始化相关配置，先验证基础数据源连接是否正常：

# spring.sql.init.platform=oracle
# spring.batch.jdbc.initialize-schema=always

如果注释后启动项目不再报ORA-01017错误，说明基础连接正常，问题出在SQL初始化脚本或Batch表初始化阶段；如果仍然报错，回到前面的账号、连接串、网络排查步骤即可。

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