Hikari DataSource抛出URL为空异常，求连接池配置排查方案

异常原因分析 #

你遇到的URL为空异常，核心问题是HikariCP的两种配置模式没有正确匹配参数：

• 当使用setDataSourceClassName()指定数据源实现类（比如你用的org.hsqldb.jdbc.JDBCDataSource）时，Hikari不会使用jdbcUrl参数，而是需要配置该数据源类自身的专属属性（比如HSQLDB的数据源需要serverName、database等，而非直接传JDBC URL）。如果只设置了dataSourceClassName却没配置对应属性，就会导致连接参数缺失，抛出URL为空的异常。
• 当使用传统的JDBC URL方式时，需要用setJdbcUrl()来指定连接串，不能只设置driverClassName却遗漏jdbcUrl。

正确配置方案 #

方案1：使用DataSourceClassName模式（Hikari官方推荐）

针对HSQLDB的JDBCDataSource，需要配置它的专属属性，而非JDBC URL：

final static String DS_DRIVER = "org.hsqldb.jdbc.JDBCDataSource";
final static String DB_SERVER = "localhost";
final static String DB_NAME = "dbone";
final static String DB_USER = "your_username"; // 替换为实际数据库用户名
final static String DB_PWD = "your_password"; // 替换为实际数据库密码

public static HikariConfig getHikariConfig() {
    HikariConfig hikariConfig = new HikariConfig();
    // 设置数据源实现类
    hikariConfig.setDataSourceClassName(DS_DRIVER);
    // 配置HSQLDB数据源的专属属性
    hikariConfig.addDataSourceProperty("serverName", DB_SERVER);
    hikariConfig.addDataSourceProperty("database", DB_NAME);
    hikariConfig.addDataSourceProperty("user", DB_USER);
    hikariConfig.addDataSourceProperty("password", DB_PWD);
    // 可选：添加连接池优化配置
    hikariConfig.setMaximumPoolSize(10);
    hikariConfig.setMinimumIdle(2);
    return hikariConfig;
}

// 初始化数据源（单例模式）
public static HikariDataSource getHikariDataSource() {
    if (hikariDataSource == null) {
        hikariDataSource = new HikariDataSource(getHikariConfig());
    }
    return hikariDataSource;
}

方案2：使用JDBC URL模式

如果你更习惯传统JDBC配置方式，确保正确设置jdbcUrl，同时可显式指定驱动类（Hikari能自动检测，但显式指定更稳妥）：

final static String DB_URL = "jdbc:hsqldb:hsql://localhost/dbone";
final static String DRIVER = "org.hsqldb.jdbc.JDBCDriver";
final static String DB_USER = "your_username";
final static String DB_PWD = "your_password";

public static HikariConfig getHikariConfig() {
    HikariConfig hikariConfig = new HikariConfig();
    // 设置JDBC连接串
    hikariConfig.setJdbcUrl(DB_URL);
    // 显式指定驱动类（可选，推荐）
    hikariConfig.setDriverClassName(DRIVER);
    // 设置数据库认证信息
    hikariConfig.setUsername(DB_USER);
    hikariConfig.setPassword(DB_PWD);
    // 连接池优化配置
    hikariConfig.setMaximumPoolSize(10);
    hikariConfig.setMinimumIdle(2);
    return hikariConfig;
}

// 初始化数据源（单例模式）
public static HikariDataSource getHikariDataSource() {
    if (hikariDataSource == null) {
        hikariDataSource = new HikariDataSource(getHikariConfig());
    }
    return hikariDataSource;
}

关键注意事项 #

• 禁止混合两种模式：不要同时设置dataSourceClassName和jdbcUrl，Hikari会优先使用dataSourceClassName模式，忽略jdbcUrl，进而引发参数缺失异常。
• 确保HSQLDB驱动包已正确引入项目依赖，否则即使配置正确也会出现驱动找不到的问题。

内容的提问来源于stack exchange，提问作者Mohd