怎样解决Spring Boot3.x连接Oracle23c时的SSL握手失败?

雨明君_5990

雨明君_5990

2026-11-15

660人浏览

原创

Spring Boot 3.x 连 Oracle 23c SSL 握手失败主因是 JDBC 未强制 TLSv1.2、JVM 缺中间 CA 证书或 JCE 策略禁用强算法;需实测服务端 TLS 版本、JDBC 显式配 oracle.net.ssl_version=TLSv1.2、完整导入证书链至 cacerts,并确认 JCE 启用无限强度策略。

怎样解决spring boot3.x连接oracle23c时的ssl握手失败?

Spring Boot 3.x 连 Oracle 23c SSL 握手失败,90% 是 JDBC 驱动没强制协商 TLSv1.2、JVM 信任库缺中间 CA 证书、或 JCE 策略未启用强算法——和 Spring Boot 版本本身无关,但 Boot 3 默认用 JDK 17+,放大了这些老问题。

确认 Oracle 23c 实际支持的 TLS 协议版本

Oracle 23c 默认只启用 TLSv1.2 及以上,但 Listener 或 Wallet 若被降级配置,仍可能只响应 TLSv1.1。别信文档,实测为准:

  • 运行 openssl s_client -connect your-db-host:1521 -tls1_2 -showcerts ;若连接成功并输出证书,说明服务端支持 TLSv1.2
  • 若报错 sslv3 alert handshake failure 或直接断开,再试 -tls1_1;若它能连上,说明服务端 TLS 配置有误,需在 sqlnet.ora 中显式设 SSL_VERSION = 1.2
  • Spring Boot 3 应用启动时加 JVM 参数:-Djdk.tls.client.protocols="TLSv1.2"(引号和逗号不能少)
  • JDBC URL 必须带参数:?oracle.net.ssl_version=TLSv1.2,不是 ssl_version=1.2,也不是 useSSL=true

导入完整证书链到 JVM 的 cacerts

浏览器能连 ≠ Java 能连。Oracle 23c 默认使用私有 CA 或中间 CA 签发的证书,而 JDK cacerts 只含根 CA。漏掉中间证书,就会报 PKIX path building failed:

  • 从真实数据库端口导出全链:openssl s_client -connect your-db-host:1521 -showcerts full-chain.pem
  • 用 awk 或手动拆分 full-chain.pem:每段 -----BEGIN CERTIFICATE-----...-----END CERTIFICATE----- 保存为独立文件(如 root.crt、intermediate.crt、server.crt)
  • 逐个查有效期:openssl x509 -in intermediate.crt -noout -dates;重点看中间证书的 notAfter——很多 2024 年签发的中间 CA 已在 2026 年过期
  • 导入顺序无关,但必须全导:keytool -importcert -file intermediate.crt -alias oracle-intermediate -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
  • 确认应用实际用的是哪个 JDK:ps aux | grep java | grep -v grep,别改错 cacerts 文件路径

验证 JCE 是否允许 AES256/GCM/SHA256withRSA

Oracle 23c 默认启用 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 等强套件;JDK 8u161 之前或企业定制版 JDK 若仍用有限强度策略,会因无共同 cipher suite 直接握手失败:

SSL Certificate Checker
SSL Certificate Checker

SSL/TLS 证书到期检查器和域名健康监控。检查证书到期、颁发者信息、SAN 条目及证书链有效性,适用于单个或多个域名。

下载
  • 写个测试类跑 Cipher.getInstance("AES/GCM/NoPadding"),不抛 NoSuchAlgorithmException 才算生效
  • OpenJDK(如 Amazon Corretto 17.0.11+、Zulu 17.42+)默认启用无限强度,但组织策略可能覆盖;检查 $JAVA_HOME/lib/security/java.security 中 crypto.policy=unlimited 是否启用
  • 若需手动补 JCE:下载对应 JDK 版本的 local_policy.jar 和 US_export_policy.jar,替换进 $JAVA_HOME/lib/security/
  • Spring Boot 3 启动日志里搜 Enabled cipher suites,确认列表里有 AES256 或 GCM 字样

避免 Wallet 与 JKS 混用导致的信任源冲突

Oracle 23c 支持 Wallet(ewallet.p12)和 JKS 两种 SSL 凭据方式,但 Spring Boot JDBC 不支持 Wallet 直连;硬配 oracle.net.wallet_location 会导致驱动忽略 cacerts,反而更难调试:

  • 彻底禁用 Wallet:JDBC URL 中不要出现 oracle.net.wallet_location 或 javax.net.ssl.trustStore 参数
  • 确保只用 cacerts:删掉所有自定义 -Djavax.net.ssl.trustStore=... JVM 参数,让驱动走默认信任库
  • Wallet 方式仅适用于 OCI 或 sqlplus 场景;Java 应用一律走证书导入 + oracle.net.ssl_version 显式控制
  • 如果已用 Wallet,且无法切换,必须把 Wallet 里的证书全部导出为 PEM,再按前述步骤导入 cacerts,不能跳过

真正卡住人的从来不是“怎么导入证书”,而是花两天时间调 ssl_version 参数,却忘了检查系统时间是否偏差超 3 分钟——2026 年 8 月,很多中间 CA 证书的 notAfter 是 2026-06-30,时间错 5 分钟就直接判定过期。

相关文章

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

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

下载

相关标签:

oracle ssl spring boot

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

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

1161

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

3473

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

3490

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

1989

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2593

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

3649

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4969

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

257

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

946

5

热门下载

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

精品课程

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