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

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 根本不触发:
使用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 设置:
立即学习“Java免费学习笔记(深入)”;
- 启动时必须加:
-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 双重确认文件状态。

















