如何解决Java连接Oracle 12c时出现的ORA-28040匹配协议错误

夜辰酱_1123

夜辰酱_1123

2026-07-17

708人浏览

原创

ORA-28040错误源于Java客户端与Oracle服务端加密握手协议不匹配,须在数据库服务器端$ORACLE_HOME/network/admin/sqlnet.ora中配置SQLNET.ALLOWED_LOGON_VERSION_SERVER=10并重启监听器,同时确保JDBC驱动单一(如ojdbc8.jar)且JVM启用TLSv1.2。

ora-28040 不是驱动没加对,也不是密码错了,而是客户端(java 应用)和 oracle 数据库服务端在“用哪套加密规则握手”这件事上彻底谈崩了。解决它,必须从服务端 sqlnet.ora 入手,而不是换驱动、改 url 或重装客户端。

改哪个文件?改数据库服务器上的 sqlnet.ora

这个参数只在数据库服务端生效,客户端改了完全没用。常见误操作是:开发在自己电脑上改了本地 sqlnet.ora,然后抱怨“配置写了还是连不上”。你必须登录数据库服务器,找到真实路径:

  • $ORACLE_HOME/network/admin/sqlnet.ora(Linux/Unix 单实例或 RAC 的 database 软件目录下)
  • 别进 $GRID_HOME 或客户端安装目录 —— 那些路径下的文件对服务端连接无影响
  • 如果 $TNS_ADMIN 环境变量被设置,监听器会优先读那个路径,得一并检查

SQLNET.ALLOWED_LOGON_VERSION_SERVER 设多少才安全又可用

值越小兼容性越强,但安全风险越高。Oracle 12c R2 及以后已废弃 SQLNET.ALLOWED_LOGON_VERSION(无后缀),继续用会刷屏告警日志。

  • SQLNET.ALLOWED_LOGON_VERSION_SERVER = 10:兼容 Oracle 10g/11g 客户端,包括 PL/SQL Developer、Toad、老版 JDBC(如 ojdbc6),是生产环境较稳妥的起点
  • SQLNET.ALLOWED_LOGON_VERSION_SERVER = 11:仅允许 12c+ 客户端,安全性更高,但会直接拒绝 11g 客户端
  • SQLNET.ALLOWED_LOGON_VERSION_SERVER = 8:理论上兼容最老系统,但 Oracle 12.2+ 已移除对该值的支持,设了也无效;19c/21c 更是完全不认

示例配置(追加到 sqlnet.ora 文件末尾即可):

SQLNET.ALLOWED_LOGON_VERSION_SERVER = 10

改完必须重启监听器,lsnrctl reload 不行

这个参数是监听器启动时一次性加载的静态配置,lsnrctl reload 不会重新读取。不重启,等于没改。

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

下载
  • 执行 lsnrctl stop → lsnrctl start
  • 确认监听器已加载新配置:用 lsnrctl status 查看输出中是否包含 “Listening Endpoints Summary”,再连一次测试
  • 如果监听器启不来,检查 sqlnet.ora 是否有语法错误(比如多了一个等号、引号不配对)

JDBC 应用仍报 ORA-28040?先查 classpath 里有没有混驱动

即使服务端设了 = 10,Java 应用仍报 ORA-28040,大概率是 classpath 里混进了多个版本的 Oracle 驱动 jar。

  • 确保只保留一个驱动:推荐 ojdbc8.jar(JDK 8+)或 ojdbc11.jar(JDK 11+),别用 ojdbc6
  • JVM 启动加参数:-Dhttps.protocols=TLSv1.2(尤其 JDK 7/8 默认不启用 TLS 1.2)
  • 检查连接 URL 是否含 ?oracle.net.authentication_services=(NONE)——这会绕过密码验证,但也会触发协议协商异常
  • Spring Boot 用户注意:application.properties 里别硬编码过时的 oracle.jdbc.thinLogonVersion 参数

真正容易被忽略的是:改了服务端配置后,如果用户密码是在旧协议下创建的(比如只存了 10g verifier),即使协议放行,仍可能触发后续的 ORA-01017。这时需要重置密码,让数据库生成新协议所需的 verifier。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

oracle java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12097

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9182

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7852

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1284

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1028

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1536

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3169

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20411

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1395

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程