java应用必须用jvm参数加载wallet，ojdbc.properties无效：驱动不读其中wallet_location等字段，唯一可靠方式是启动时指定-doracle.net.wallet_location和-doracle.net.ssl_server_cert_dn，且jdbc url须为tcps协议、2484端口、完整description语法。
Java应用必须用JVM参数加载Wallet，ojdbc.properties无效
Oracle JDBC驱动（ojdbc8.jar及以上）压根不读ojdbc.properties里的wallet_location或javax.net.ssl.truststore字段。这个文件只管连接池参数（比如oracle.jdbc.maxstatements），对Wallet完全无感。往里面写任何Wallet相关配置都是白费力气。
常见错误现象：
- 应用启动没报错，但一连库就抛
ORA-12546: TNS:permission denied或ORA-28759: failure to open file - Wallet解压后权限正确、
sqlnet.ora也配了，JDBC就是不认
唯一可靠方式是JVM启动时显式传入两个系统属性：
-
-Doracle.net.wallet_location=/abs/path/to/wallet（必须是绝对路径，且JVM进程对路径及其所有父目录都有x权限） -
-Doracle.net.ssl_server_cert_dn="CN=..."（必须与Wallet中证书的Subject DN逐字符一致，大小写、空格、逗号顺序都不能差；可用orapki wallet display -wallet /path/to/wallet查看）
JDBC URL必须用TCPS协议+完整DESCRIPTION语法
Oracle Wallet认证不是“自动启用”的——JDBC默认走TCP，即使Wallet已加载也不会触发证书握手。要让驱动真正用上Wallet里的凭证和信任链，URL必须同时满足三个硬性条件：协议为TCPS、端口为SSL监听端口（通常是2484）、结构为标准Oracle Net语法。
正确写法示例：
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCPS)(HOST=mydb.example.com)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=orcl)))
常见错误：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 写成
jdbc:oracle:thin:@mydb.example.com:2484/orcl（简写格式不解析Wallet） - 漏掉
DESCRIPTION结构，或把SERVICE_NAME换成SID - 用
1521端口（自治数据库强制2484，传统库若未配置SSL监听也不通） - URL里带用户名密码（违背免密初衷，且自治数据库会直接拒绝）
Wallet目录权限和文件组成不能出错
驱动只认目录，不是单个文件；且对文件权限极其敏感。生产环境必须确保：
- 目录下至少包含
cwallet.sso（加密、可分发），ewallet.p12仅用于本地调试，上线前应删除 - Linux/macOS下执行
chmod 600 /path/to/wallet/cwallet.sso（权限高于600会报ORA-28860: SSL/TLS error） - 路径必须绝对——Spring Boot里不能写
./wallet或classpath:wallet/；Docker容器中要确认挂载路径真实存在且ls -l /wallet/cwallet.sso能看见 - 如果Wallet是auto-login类型（含
cwallet.sso），URL里就不该出现密码；若只有ewallet.p12，驱动会要求oracle.net.wallet_password，这违背“免密”设计目标
Spring Boot + HikariCP无法通过data-source-properties透传Wallet参数
HikariCP不会把spring.datasource.hikari.data-source-properties里的Wallet相关属性转发给Oracle驱动。Wallet加载发生在驱动初始化阶段，远早于DataSource构建。
可行方案只有两种：
- 启动脚本里加
-Doracle.net.wallet_location=...和-Doracle.net.ssl_server_cert_dn=...（最推荐） - 在
application.properties中设spring.datasource.hikari.data-source-properties.oracle.net.wallet_location=/path（注意：这是HikariCP的兜底行为，并非Oracle驱动原生支持，部分版本可能不稳定）
绝对不能在代码里调用System.setProperty()动态设置——驱动在DriverManager.getConnection()前就完成了初始化，此时设值已失效。
Wallet路径一旦写错、权限没收紧、或ssl_server_cert_dn和证书实际DN有任意一个字符偏差，连接就会静默失败或报看似无关的网络错误。这些点没法靠日志快速定位，得逐项人工核对。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
