Wallet路径必须通过JVM系统属性-Doracle.net.wallet_location指定绝对路径,URL中写wallet_location或wallet_path参数无效;驱动直接忽略,连接走明文TCP,SSL静默失效。
Wallet路径必须用JVM系统属性传,URL里写无效
oracle jdbc驱动(ojdbc8+)根本不认wallet_location或wallet_path这类url参数。你在jdbc:oracle:thin:@?wallet_location=/path里加这个,驱动直接忽略——既不报错也不生效,连接照样走明文tcp,ssl静默失效。
正确做法是通过JVM启动参数指定绝对路径:
-
-Doracle.net.wallet_location=/opt/oracle/wallet(Linux/macOS) -
-Doracle.net.wallet_location=C:/oracle/wallet(Windows,推荐正斜杠)
Spring Boot用户别在application.properties里往spring.datasource.url硬塞wallet参数;稳妥做法是配spring.datasource.hikari.data-source-properties.oracle.net.wallet_location=/path,或者直接在启动脚本里加-D参数。
URL必须用TCPS + 完整Oracle Net语法,不能简写
普通Oracle数据库(非自治ADB)不认tcps://host:2484这种ADB专用格式。端口必须从DBA确认:常见是1522、2483等,不是猜出来的。
URL必须显式展开为Oracle Net语法,且PROTOCOL必须是TCPS:
- ✅ 正确:
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=mydb.example.com)(PORT=1522))(CONNECT_DATA=(SERVICE_NAME=orcl))) - ❌ 错误:
jdbc:oracle:thin:@mydb.example.com:1522/orcl(没TCPS、没DESCRIPTION) - ❌ 错误:
jdbc:oracle:thin:@//mydb.example.com:2484/ORCL(普通库不认2484)
自治数据库(ADB)是例外:必须用tcps+2484+完整DESCRIPTION,且SERVICE_NAME要带.adb.oraclecloud.com后缀,大小写敏感。
cwallet.sso权限不对会触发ORA-28860但不提示原因
Linux/macOS下,如果cwallet.sso权限高于600(比如644或664),ojdbc驱动会拒绝加载并抛出ORA-28860: SSL/TLS error。这个错误完全没提权限问题,容易误判为证书或网络故障。
修复命令:
chown appuser:appgroup /opt/oracle/walletchmod 700 /opt/oracle/walletchmod 600 /opt/oracle/wallet/cwallet.sso
Windows下需确保当前JVM进程用户对Wallet目录有读取+执行权限(目录需可遍历)。
别混用Wallet和javax.net.ssl.*参数
Wallet是Oracle原生证书容器,JDK的javax.net.ssl.trustStore等参数是Java标准密钥库机制——二者不可共存。用了Wallet就别配javax.net.ssl.trustStore,否则驱动会忽略Wallet并报ORA-28860。
Wallet方式下,这些JVM参数必须清空或未设置:
javax.net.ssl.trustStorejavax.net.ssl.keyStorejavax.net.ssl.trustStorePassword
如果必须用JKS(比如统一Spring Boot SSL配置),就得走标准Java SSL流程,但得显式设oracle.net.ssl_version=TLSv1.2(尤其JDK 17+),否则可能降级到不支持的协议。
最易被忽略的是Wallet目录权限和JVM参数冲突——这两个点不出错时一切正常,一出错就是静默失败或ORA-28860,排查成本极高。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











