如何控制HikariCP异常？数据库故障时保障服务正常启动

针对你遇到的HikariCP数据库连接失败导致服务启动终止的问题，以下是几个可行的解决思路：

1. 配置HikariCP跳过初始连接验证 #

HikariCP的initializationFailTimeout参数默认值为1（立即失败），将其设置为**-1**可以跳过启动时的初始连接检查，仅在第一次真正获取连接时才尝试建立连接。

你可以直接在代码的HikariConfig中添加配置：

config.setInitializationFailTimeout(-1);

或者在application配置文件中设置：

spring.datasource.hikari.initialization-fail-timeout=-1

2. 避免返回null，提供备用DataSource实现 #

当前代码中连接失败时返回null，Spring容器会因为无法创建合法的DataSource Bean而启动失败。你需要返回一个合法的DataSource实现作为备用，比如自定义一个模拟DataSource，在实际调用时抛出连接异常：

修改你的datasource方法，并添加MockDataSource实现：

@Bean
@Lazy
public DataSource datasource(DBSecret secret,
                             @Value("${spring.datasource.driverClassName}") String driverClass) {
    HikariConfig config = new HikariConfig();
    config.setJdbcUrl(secret.getUrl());
    config.setUsername(secret.getUsername());
    config.setPassword(secret.getPassword());
    config.setDriverClassName(driverClass);
    config.setConnectionTimeout(1800000);
    config.setInitializationFailTimeout(-1); // 配合跳过初始检查
    try {
        return new HikariDataSource(config);
    } catch (Exception e) {
        e.printStackTrace();
        // 返回备用模拟DataSource
        return new MockDataSource();
    }
}

// 自定义模拟DataSource，仅在实际获取连接时抛出异常
class MockDataSource implements DataSource {
    @Override
    public Connection getConnection() throws SQLException {
        throw new SQLTransientConnectionException("数据库连接暂不可用，请稍后重试");
    }

    @Override
    public Connection getConnection(String username, String password) throws SQLException {
        return getConnection();
    }

    @Override
    public <T> T unwrap(Class<T> iface) throws SQLException {
        throw new SQLException("不支持unwrap操作");
    }

    @Override
    public boolean isWrapperFor(Class<?> iface) throws SQLException {
        return false;
    }

    @Override
    public PrintWriter getLogWriter() throws SQLException {
        return null;
    }

    @Override
    public void setLogWriter(PrintWriter out) throws SQLException {}

    @Override
    public void setLoginTimeout(int seconds) throws SQLException {}

    @Override
    public int getLoginTimeout() throws SQLException {
        return 0;
    }

    @Override
    public Logger getParentLogger() throws SQLFeatureNotSupportedException {
        throw new SQLFeatureNotSupportedException();
    }
}

3. 延迟DataSource初始化（懒加载） #

给DataSource Bean添加@Lazy注解，让Spring容器不在启动时初始化该Bean，而是在第一次实际使用时才尝试创建连接。这样启动过程不会被数据库连接失败打断。

注意：如果其他Bean依赖该DataSource，也需要给这些Bean添加@Lazy，或者在使用时处理可能的初始化异常。

4. 排除Spring Boot自动配置的干扰 #

如果你的项目使用了Spring Boot的自动配置，DataSourceAutoConfiguration可能会在启动时强制验证数据库连接。可以在启动类上排除该自动配置类，完全自定义DataSource的创建逻辑：

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

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