ORA-01017表示连接成功但认证失败，问题必在凭证、账户状态、PDB路由、驱动版本或sqlnet.ora配置；需用sqlplus直连验证，并检查account_status、service_name、ojdbc版本及SQLNET.ALLOWED_LOGON_VERSION_SERVER设置。
ora-01017 错误不是连接失败，而是连接已通、认证被拒——只要抛出这个错误，就说明 tcp 层和监听器都正常，问题一定出在凭证或认证协商环节。
确认用户名密码是否真正有效
看似输对了，但 Oracle 12c+ 默认开启密码大小写敏感（sec_case_sensitive_logon=true），小写 admin 和大写 ADMIN 是两个不同密码。用 sqlplus 在应用服务器本机直连验证最可靠：
sqlplus "app_user/MyPass123@//db-host:1521/orclpdb1"
如果这步失败，说明不是 Java 或 JDBC 的问题；此时优先查：
-
SELECT username, account_status, expiry_date FROM dba_users WHERE username = 'APP_USER'—— 状态是否为OPEN？是否过期或锁定？ - 若状态异常，执行
ALTER USER app_user ACCOUNT UNLOCK和ALTER USER app_user IDENTIFIED BY newpass - 避免在 JDBC URL 中硬编码明文密码，改用连接池的凭据管理机制
检查 JDBC URL 是否匹配 PDB 和 service_name
Oracle 12c+ 强制使用多租户架构后，SID（如 :orcl）基本失效，必须用 service_name（如 /orclpdb1）。错写成 jdbc:oracle:thin:@db-host:1521:orcl 就会触发 ORA-01017，因为监听器把请求路由到了 CDB 根容器，而用户实际在 PDB 中。
查清当前服务名：
立即学习“Java免费学习笔记（深入）”；
lsnrctl status | grep -A 5 "Services"
正确 URL 示例：
jdbc:oracle:thin:@//db-host:1521/orclpdb1
注意格式差异：
- 带双斜杠
//+ service_name → 推荐，明确启用 TNS 连接描述符解析 - 用冒号
:+ SID → 仅兼容旧库，12.2+ 环境下极易失败 - URL 中不能漏掉
pdb后缀，也不能写成orclpdb1.localdomain这类完整域名（除非 tnsnames.ora 显式定义）
验证 JDBC 驱动与 Oracle 服务端版本兼容性
ojdbc6.jar（编译于 JDK 6）无法完成 Oracle 19c/21c 的密码哈希协商，即使用户名密码完全正确，也会退回到 ORA-01017。这不是配置问题，是协议不匹配。
检查驱动版本对应关系：
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- Oracle 12.2+ → 至少用
ojdbc8.jar（JDK 8 编译） - Oracle 19c/21c → 必须用
ojdbc11.jar或更高（JDK 11+） - 确认 classpath 中无多个 ojdbc 版本共存（尤其 Tomcat 的
lib/下易残留旧包）
驱动不匹配时，sqlplus 可连、Java 死活报 ORA-01017，就是典型信号。
检查 sqlnet.ora 的认证版本限制
Oracle 12.2+ 默认禁用旧版密码算法，若客户端驱动太老或系统策略收紧，服务端会拒绝认证请求并统一返回 ORA-01017。
临时绕过（仅用于诊断）：
在数据库服务器的 $ORACLE_HOME/network/admin/sqlnet.ora 中添加：
SQLNET.ALLOWED_LOGON_VERSION_SERVER=8
然后重启监听：lsnrctl reload（非必须 restart）
但这只是权宜之计。长期方案是升级驱动 + 重置用户密码（触发新哈希存储）：
ALTER USER app_user IDENTIFIED BY newpass;
注意：该语句在 12.2+ 上会自动使用 SHA-2 哈希，前提是客户端能协商成功。
最容易被忽略的一点：ORA-01017 是个“假阳性”错误码——它掩盖了底层真实的协议不匹配、PDB 路由失败、密码文件缺失（如 sys 登录）、甚至 sqlnet.ora 中 SQLNET.AUTHENTICATION_SERVICES 配置错误等多种情况。不要只盯着用户名密码改来改去，先用 sqlplus 直连复现，再逐层比对环境差异。
