spring boot 本身不处理 oracle wallet，真正起作用的是 ojdbc8 驱动和 jvm 级配置；wallet 必须解压到本地文件系统并用 -doracle.net.tns_admin 指定绝对路径，配合 tcps 协议与 tns 别名连接，且需 ojdbc8 ≥ 21.9、正确 driver-class-name 及 hikaricp 超时调优。
spring boot 本身不处理 oracle wallet，真正起作用的是 ojdbc8 驱动和 jvm 级的配置。你配错任何一环——比如把 wallet 压在 jar 里、用错协议、漏掉 -doracle.net.tns_admin——连接就会卡在 ora-28759: failure to open file 或静默超时。
Wallet 必须解压到本地文件系统且路径对 JVM 可见
ADW 下载的 Wallet_*.zip 不能直接扔进 src/main/resources 或打包进 JAR；ojdbc8 在启动 TLS 握手前会尝试读取 cwallet.sso 和 tnsnames.ora，而它只认真实文件路径。
- JVM 启动时必须显式指定：
-Doracle.net.tns_admin=/opt/oracle/wallet（Linux）或-Doracle.net.tns_admin=C:\oracle\wallet（Windows，注意双反斜杠或正斜杠） - 该路径下必须包含解压后的全部文件：
cwallet.sso、tnsnames.ora、keystore.jks、truststore.jks等 - 运行进程的用户（如 systemd 服务里的
spring-boot.jar）必须有读取权限：chmod 600 /opt/oracle/wallet/cwallet.sso - 不要用
file://或 classpath 路径；ojdbc8不解析 URL 形式路径
URL 格式必须用 TNS 别名 + tcps:// 协议，不能拼 host/port
ADW 控制台给的连接字符串是误导性的。你不能把 adb1234567890_high 当作普通字符串塞进 jdbc:oracle:thin:@host:port:sid 模板里——它必须被 tnsnames.ora 解析。
- 正确写法：
spring.datasource.url=jdbc:oracle:thin:@adb1234567890_high - 必须搭配
tcps://协议隐含在 Wallet 配置中，不是写在 URL 里；URL 中出现tcps://反而会报错 -
tnsnames.ora里定义的别名必须完全一致（区分大小写），且不能含空格或特殊字符 - 禁止加查询参数如
?oracle.net.ssl_server_dn_match=true：Wallet 已内置证书链校验逻辑，重复开启会导致握手失败
ojdbc8 版本与 driver-class-name 不可省略
低于 21.9 的 ojdbc8 对 ADW 的 TLS 1.3 支持不完整，常见于旧版 Spring Boot Starter（如 2.7.x 默认带 21.7），升级后才能稳定握手。
- Maven 依赖必须显式声明（runtime scope）：
<groupid>com.oracle.database.jdbc</groupid><artifactid>ojdbc8</artifactid><version>23.7.0.24.04</version> -
spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver必须写全，不能简写为oracle.jdbc.OracleDriver；HikariCP 在 fallback 时可能加载错误驱动 - 不要引入
oraclepki.jar、osdt_core.jar等旧辅助包——ojdbc8 ≥ 21.9已内建 PKI 支持
HikariCP 连接池需禁用预检并延长超时
Wallet 初始化 TLS 握手比普通 TCP 连接慢得多，尤其首次加载 cwallet.sso 时可能耗时 5–10 秒。默认连接池健康检查会误判为失败。
- 关闭自动连接测试：
spring.datasource.hikari.connection-test-query=SELECT 1 FROM DUAL（仅用于验证连通性，非 SSL 握手） - 调高超时：
spring.datasource.hikari.connection-timeout=30000（最低建议值） - 禁用连接池启动时的预填充（避免冷启动卡住）：
spring.datasource.hikari.initialization-fail-timeout=-1 - 别信
spring-cloud-azure-starter-keyvault-certificates：它不读 Wallet，也不参与 ojdbc8 的 TLS 流程，配了白配
最常被忽略的其实是权限和路径分隔符——cwallet.sso 文件不可读、TNS_ADMIN 路径里混用 和 /、或者把 Wallet 放在容器里却没挂载到 JVM 可见位置，这些都会让整个流程在无声中失败。调试时先确认 ls -l /opt/oracle/wallet/cwallet.sso 和 java -Doracle.net.tns_admin=/opt/oracle/wallet -cp ... YourApp 能否手动连通，再集成到 Spring Boot。
