如何在Java 11中使用Oracle Wallet实现免密安全连接?

千雪吖_7503

千雪吖_7503

2026-11-16

846人浏览

原创

Java 11 连 Oracle Wallet 必须使用 ojdbc11.jar,且需配置绝对路径的 wallet_location、600 权限的 cwallet.sso、TCPS 协议的完整 DESCRIPTION URL,并禁用冲突的 JVM SSL 参数,否则将出现 ORA-28860 或静默失败。

如何在java 11中使用oracle wallet实现免密安全连接?

Java 11 连 Oracle Wallet 必须用 ojdbc11.jar,且不能混用 JVM SSL 参数;否则必报 ORA-28860 或静默握手失败。

Wallet 路径和权限必须严格满足驱动要求

Oracle JDBC 驱动(尤其是 ojdbc11)在 Java 11 下对 Wallet 的加载路径和文件权限极其敏感:

  • oracle.net.wallet_location 必须是**绝对目录路径**(如 /app/config/wallet),不是 cwallet.sso 文件路径,也不是相对路径或 classpath: 前缀
  • Linux/macOS 下,cwallet.sso 文件权限必须为 600:chmod 600 /app/config/wallet/cwallet.sso;权限为 644 或更高会直接拒绝加载
  • Java 进程用户(如 java -jar app.jar 的运行用户)必须有该目录及文件的读取权限;Docker 中注意挂载后 UID 是否匹配
  • Spring Boot 中若通过 spring.datasource.hikari.data-source-properties.oracle.net.wallet_location 设置,YAML 缩进和引号必须正确,键名不能简写为 walletLocation

连接 URL 必须用 TCPS 协议 + 完整 DESCRIPTION 语法

Java 11 下绕过 Wallet 加载的常见错误,往往源于 URL 格式不合规——驱动不会报错,但 Wallet 根本不触发:

Build Java agent transport gateways with Atmosphere
Build Java agent transport gateways with Atmosphere

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

下载
  • URL 必须显式使用 tcps 协议、端口 2484,且完整展开为 Oracle Net 描述符:jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=mydb.adb.oraclecloud.com)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=mydb_high.adb.oraclecloud.com)))
  • 不能简化成 jdbc:oracle:thin:@mydb.adb.oraclecloud.com:2484/mydb_high.adb.oraclecloud.com,否则跳过 Wallet 初始化流程
  • URL 中严禁携带用户名、密码、?wallet_location= 等参数——这些由系统属性或数据源配置接管
  • 自治数据库(ADB)场景下,HOST 和 SERVICE_NAME 必须从控制台“连接信息”页原样复制,大小写和后缀(如 .adb.oraclecloud.com)均敏感

JVM 启动参数和环境必须清空干扰项

Java 11 默认启用更严格的 TLS 策略,且 ojdbc11 会主动忽略冲突的 JVM SSL 设置:

  • 启动时必须加:-Doracle.net.wallet_location=/absolute/path/to/wallet/dir;不能在代码中用 System.setProperty() 动态设置——驱动初始化早于该调用
  • 必须确保未设置以下任一 JVM 参数,否则驱动将弃用 Wallet 并尝试走标准 JVM SSL 流程,导致 ORA-28860:javax.net.ssl.trustStore、javax.net.ssl.keyStore、javax.net.ssl.trustStorePassword
  • 若应用依赖其他组件(如 Spring Boot 的 server.ssl.*)启用了全局 SSL,需隔离配置,避免污染 Oracle 连接上下文
  • Java 11+ 默认禁用 TLS 1.0/1.1,Wallet 中的证书必须支持 TLSv1.2(或 TLSv1.3);可用 orapki wallet display -wallet /path/to/wallet 检查证书链是否完整(含根 CA 和中间证书)

最容易被忽略的是:Wallet 目录里必须同时存在 cwallet.sso 和 ewallet.p12(尤其 TDE 场景),且 ewallet.p12 不可被 Java 进程因权限或路径问题静默跳过——驱动不会报错,但密钥加载失败会导致后续 ORA-28374。务必用 ls -l 和 stat 双重确认文件状态。

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

12697

6

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

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

2023.07.05

9802

9

java自学难吗
java自学难吗

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

2023.07.31

8332

8

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

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

2023.08.01

1344

3

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

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

2023.08.02

1068

3

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

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

2023.08.02

1596

5

java有什么用
java有什么用

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

2023.08.02

3329

5

java在线网站
java在线网站

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

2023.08.03

20551

3

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

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

2023.08.03

1435

8

热门下载

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

精品课程

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