oracle wallet 是 oracle 提供的加密凭证存储机制，本质是受口令保护的加密文件（或目录），用于安全存放数据库连接凭据、ssl 证书等敏感信息，避免明文密码泄露；它使应用通过指定别名（如 jdbc:oracle:thin:/@mydb）自动解密获取凭据，无需硬编码用户名密码。
oracle wallet 是什么，为什么不用用户名密码
Oracle Wallet 是 Oracle 提供的加密凭证容器，用于安全存储数据库连接所需的用户名、密码、SSL 配置等。它不等于“跳过认证”，而是把认证凭据从明文配置（如 jdbc:oracle:thin:@host:port/service）移到受操作系统权限和密码保护的加密文件中。Java 应用通过 JDBC 连接时，只需指定 Wallet 路径，驱动自动读取并完成身份验证——这避免了硬编码密码、配置文件泄露、日志打印敏感信息等典型风险。
关键判断：如果你的应用部署在可信内网且由专人维护，Wallet 是提升合规性（如等保、GDPR）的低成本手段；但若运行在不可信环境（如共享主机），Wallet 文件本身被窃取后，仍可能被暴力破解（尤其 Wallet 密码弱），此时需配合 OS 文件权限（chmod 600）和强 Wallet 口令。
创建并配置 Oracle Wallet 的完整流程
Wallet 创建必须使用 Oracle 自带的 mkstore 工具（随 Oracle Client 或 Instant Client 安装），不能用 Java 或第三方工具生成。常见错误是直接修改 cwallet.sso 文件或试图用 Keytool 替代——会报 IO Error: Invalid wallet type。
实操步骤：
- 确保已安装 Oracle Instant Client（含
mkstore），版本需与 JDBC 驱动匹配（例如使用 ojdbc8.jar 就用 19c 或 21c client） - 创建空 Wallet：
mkstore -wrl /path/to/wallet -create
，按提示输入 Wallet 口令（记住，后续 Java 连接要用） - 添加数据库别名凭证：
mkstore -wrl /path/to/wallet -createCredential mydb user1 password1
，其中mydb是你在tnsnames.ora中定义的服务别名（或直接用完整连接串） - 确认生成两个文件：
cwallet.sso（加密、可分发）和ewallet.p12（未加密、仅本地调试用），生产环境只保留cwallet.sso
JDBC 连接字符串怎么写才生效
JDBC URL 必须启用 Oracle Wallet 模式，即使用 jdbc:oracle:thin:/@<alias></alias> 格式（注意开头是 /@，不是 :@），且必须配合 JVM 启动参数或代码中显式设置 Wallet 路径。
常见错误：
- URL 写成
jdbc:oracle:thin:@mydb—— 驱动会尝试传统连接，报ORA-01017: invalid username/password - 漏设
-Doracle.net.wallet_location=/path/to/wallet，或路径指向了ewallet.p12而非包含cwallet.sso的目录 - Linux 下路径权限不对：
cwallet.sso所在目录需对运行 Java 的用户可读，否则报java.sql.SQLException: IO Error: Unknown host specified（错误提示极具误导性）
正确示例（JVM 参数 + URL）：
-Doracle.net.wallet_location=/opt/oracle/wallet
对应连接 URL：jdbc:oracle:thin:/@mydb
Wallet 连接在 Spring Boot 中如何集成
Spring Boot 默认不识别 oracle.net.wallet_location 系统属性，若在 application.properties 里只配 spring.datasource.url=jdbc:oracle:thin:/@mydb，启动时会卡在连接池初始化并抛出超时异常。
必须提前注入系统属性，推荐方式：
- 在
main()方法最开头加：System.setProperty("oracle.net.wallet_location", "/opt/oracle/wallet"); - 或通过
@PostConstruct初始化 DataSource 前手动设置（但要确保早于 HikariCP 初始化） - 禁用 HikariCP 的连接测试（
spring.datasource.hikari.connection-test-query=SELECT 1 FROM DUAL）——Wallet 连接首次建立较慢，测试查询可能失败导致启动失败
注意：Spring Boot 3.x + Jakarta EE 9+ 环境下，ojdbc11.jar 需搭配 Oracle DB 19c+，低版本 Wallet 可能因 TLS 协议不兼容报 javax.net.ssl.SSLHandshakeException: No appropriate protocol。
Wallet 的真正难点不在创建，而在于路径、权限、JDBC URL 格式三者必须严丝合缝；任何一处偏差都会表现为完全无关的错误码，比如连不上却报 SSL 异常，或者提示找不到主机——其实只是 cwallet.sso 没读到。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
