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 中。
查清当前服务名:
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 直连复现,再逐层比对环境差异。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










