Java使用SSL cwallet.sso连接Oracle数据库出现类未找到异常求助

报错信息：Exception in thread "main" java.lang.NoClassDefFoundError: oracle/security/crypto/core/AuthenticationException

报错根因 #

该报错是因为项目缺少Oracle SSL认证所需的加密依赖包，仅引入JDBC驱动不足以支持cwallet.sso钱包的验证逻辑。

修复方案 #

1. 补全缺失依赖 #

你需要额外引入三个和你所用ojdbc版本完全一致的Oracle官方依赖包：

• oraclepki.jar：Oracle PKI实现包，提供代码中用到的oracle.security.pki.OraclePKIProvider类
• osdt_core.jar：包含报错缺失的oracle.security.crypto.core.AuthenticationException类
• osdt_cert.jar：证书处理相关依赖

如果是Maven项目，将三个jar导入本地/私有仓库后引入pom即可；普通Java项目直接将jar放入项目lib目录，添加到构建路径中。

2. 现有代码优化 #

你提供的代码可以做以下调整规避潜在问题：

• 替换废弃的驱动类：将oracle.jdbc.driver.OracleDriver替换为官方推荐的oracle.jdbc.OracleDriver
• 移除冗余的驱动注册逻辑：JDBC4.0及以上版本会自动扫描类路径下的JDBC驱动，无需手动调用DriverManager.registerDriver()方法
• 将cwallet.sso的本地硬编码路径改为配置项读取，方便后续多环境切换

3. 连接串校验 #

确认你的数据库连接串符合TCPS协议要求：

• 连接串必须以jdbc:oracle:thin:@开头
• 协议指定为TCPS，端口默认是2484（不要用普通非SSL的1521端口）
• 完整格式参考：jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCPS)(HOST=数据库地址)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=数据库服务名)))

完成以上调整后即可解决类未找到报错，同时完成SSL钱包连接验证。

内容的提问来源于stack exchange，提问作者S Mugunthan kumar