Java应用如何连接Oracle自治数据库_使用Wallet和JDBC-Oracle-PHP中文网

oracle自治数据库（adb）强制ssl连接且仅支持wallet认证：jdbc url须用tcps协议、2484端口及完整description语法，不带用户名密码；必须通过-doracle.net.wallet_location指定绝对路径指向含cwallet.sso的wallet目录，linux/macos下cwallet.sso权限需为600，驱动自动识别wallet内凭证。

oracle自治数据库（adb）强制要求ssl连接，且只接受wallet方式认证——jdbc url里不能带用户名密码，也不能用javax.net.ssl.*参数加载jks。这是硬性限制，不是配置选项。

Wallet路径必须是绝对路径且权限严格

自治数据库下发的Wallet压缩包解压后，目录里必须包含cwallet.sso和ewallet.p12（部分版本可能只有前者）。JDBC驱动只认这个目录，不是文件；且cwallet.sso在Linux/macOS下权限不能高于600：

chmod 600 /path/to/wallet/cwallet.sso（否则报ORA-28860: SSL/TLS error）
路径必须绝对——Spring Boot里用file:/app/config/wallet/，别写./wallet或classpath:wallet/
Docker容器中注意挂载路径映射是否真实存在，ls -l /wallet/cwallet.sso要能看见且可读

jdbc url必须用tcps协议+2484端口+完整DESCRIPTION

自治数据库不开放1521端口，只走tcps协议和默认端口2484。URL格式不能简化，必须展开为标准Oracle Net语法：

jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=adb.region.oraclecloud.com)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=dbname_high.adb.oraclecloud.com)))

HOST和SERVICE_NAME必须从ADB控制台“连接信息”页复制，大小写敏感，带.adb.oraclecloud.com后缀
不能省略CONNECT_DATA块，也不能把SERVICE_NAME换成SID
URL里不出现用户名、密码、?wallet_location=等参数——这些由JVM系统属性或数据源配置接管

OracleDriver必须显式设置wallet_location系统属性

ojdbc8.jar（19c+推荐用ojdbc11）会自动查找oracle.net.wallet_location系统属性，而不是靠JDBC URL传参。启动时必须加：

Gradle 9.8.0

下载

-Doracle.net.wallet_location=/absolute/path/to/wallet/dir

这个值是目录路径，不是cwallet.sso文件路径
不能通过System.setProperty()在代码里动态设——驱动在DriverManager.getConnection()前就初始化了
Spring Boot应用应在application.properties里配spring.datasource.hikari.data-source-properties.oracle.net.wallet_location=/path，或启动脚本里加-D
如果同时设置了javax.net.ssl.trustStore，驱动会直接忽略wallet并报ORA-28860

连接时不再需要用户名密码参数

Wallet里已预置了用户凭证（如ADMIN），JDBC连接时getConnection(url, props)的props里不要设user和password，否则会覆盖Wallet行为并失败：

正确写法：DriverManager.getConnection(url, new Properties())
错误写法：props.setProperty("user", "ADMIN"); props.setProperty("password", "...")
若用HikariCP，确保username和password配置项为空或删掉，否则连接池初始化直接报ORA-01017: invalid username/password
Wallet里没存对的用户？用mkstore -wrl /path/to/wallet -listCredential检查，再用-createCredential补全

最容易被忽略的是：自治数据库的Wallet不支持客户端证书双向认证（SSL_CLIENT_AUTHENTICATION=TRUE），所以服务端配置里别开这个开关；另外，JDK 17+默认禁用TLSv1.1及以下，但Wallet本身不控制协议版本——只要ojdbc8+和数据库端协商出TLSv1.2即可，无需额外设oracle.net.ssl_version。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南