Java使用HikariCP创建Oracle连接池出现类转换异常如何解决

数据老陈

2026-10-2

问题原因

核心配置错误：setDataSourceClassName() 方法要求传入实现了javax.sql.DataSource接口的类全限定名，代码中传入的oracle.jdbc.driver.OracleDriver是JDBC驱动类，并未实现DataSource接口，因此触发类转换异常。
次要配置错误：代码中填写的端口5432是PostgreSQL的默认端口，Oracle数据库默认端口为1521，修复时需要同步调整。

修复方案

提供两种常用的可行配置方式：

方案1：使用Oracle官方DataSource实现类配置

Oracle JDBC包中自带的DataSource实现类为oracle.jdbc.pool.OracleDataSource，替换对应配置即可，修改后的代码如下：

private static DataSource dataSource() {
    final HikariDataSource ds = new HikariDataSource();
    ds.setMaximumPoolSize(100);
    // 替换为Oracle的DataSource实现类
    ds.setDataSourceClassName("oracle.jdbc.pool.OracleDataSource");
    ds.addDataSourceProperty("serverName", "localhost");
    // 修正为Oracle默认端口
    ds.addDataSourceProperty("port", "1521");
    ds.addDataSourceProperty("databaseName", "test");
    ds.addDataSourceProperty("user", "user");
    ds.addDataSourceProperty("password", "password");
    return ds;
}

方案2：直接配置JDBC URL（更简洁通用）

无需指定DataSource类名，直接通过JDBC连接串配置即可，代码更简洁，是更常用的配置方式：

private static DataSource dataSource() {
    final HikariDataSource ds = new HikariDataSource();
    ds.setMaximumPoolSize(100);
    // 直接配置Oracle JDBC URL，SID格式写法如下
    ds.setJdbcUrl("jdbc:oracle:thin:@localhost:1521:test");
    // 直接调用Hikari提供的用户名密码配置方法
    ds.setUsername("user");
    ds.setPassword("password");
    return ds;
}

如果Oracle使用的是服务名而非SID，将JDBC URL调整为jdbc:oracle:thin:@//localhost:1521/你的服务名即可。

额外注意事项