如何让SpringBoot启动时重试数据库连接直至成功？

这个问题确实挺常见的——Docker Compose里哪怕你配置了depends_on，也只能保证容器的启动顺序，没法确保数据库服务真的就绪可用。要让Spring Boot在启动阶段自动重试数据库连接，而不是一失败就退出，这里有几个实用的方案：

这是比较简洁的实现方式，利用Spring Retry的重试机制，给数据源的初始化逻辑加上自动重试能力：

1. 先引入Spring Retry的依赖（以Maven为例）：

<dependency>
    <groupId>org.springframework.retry</groupId>
    <artifactId>spring-retry</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

2. 在你的Spring Boot启动类上开启Retry功能：

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

3. 自定义数据源配置类，把初始化逻辑包装在带重试注解的方法里：

@Configuration
@Slf4j
public class DataSourceConfig {

    @Value("${spring.datasource.url}")
    private String url;

    @Value("${spring.datasource.username}")
    private String username;

    @Value("${spring.datasource.password}")
    private String password;

    @Value("${spring.datasource.driver-class-name}")
    private String driverClassName;

    @Bean
    @Retryable(value = {CommunicationsException.class, SQLException.class},
            maxAttempts = Integer.MAX_VALUE,
            backoff = @Backoff(delay = 2000, multiplier = 1.5))
    public DataSource dataSource() {
        HikariDataSource dataSource = new HikariDataSource();
        dataSource.setJdbcUrl(url);
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        dataSource.setDriverClassName(driverClassName);

        // 主动触发连接测试，确保初始化阶段就验证连接有效性
        try (Connection conn = dataSource.getConnection()) {
            if (!conn.isValid(1000)) {
                throw new SQLException("数据库连接无效");
            }
        } catch (SQLException e) {
            throw new RuntimeException(e);
        }
        return dataSource;
    }

    @Recover
    public DataSource recover(Exception e) {
        // 因为设置了无限重试，理论上不会走到这里，可添加兜底日志
        log.error("所有重试尝试后仍无法连接数据库", e);
        throw new RuntimeException("数据库连接失败，应用无法启动", e);
    }
}

这里的@Retryable注解指定了要捕获的异常类型（比如你遇到的CommunicationsException），设置了无限重试次数，并且用指数退避的方式（每次重试间隔从2秒开始，乘以1.5递增），避免频繁重试给数据库造成不必要的压力。

如果不想引入额外依赖，也可以自己编写一个启动前的检查逻辑，在Spring Boot完成启动前，循环尝试连接数据库直到成功：

@Component
@Slf4j
public class DatabaseConnectionChecker implements ApplicationListener<ApplicationStartingEvent> {

    @Value("${spring.datasource.url}")
    private String url;

    @Value("${spring.datasource.username}")
    private String username;

    @Value("${spring.datasource.password}")
    private String password;

    @Value("${spring.datasource.driver-class-name}")
    private String driverClassName;

    private static final int RETRY_INTERVAL = 2000; // 2秒重试一次

    @Override
    public void onApplicationEvent(ApplicationStartingEvent event) {
        log.info("开始预检查数据库连接...");
        boolean connected = false;
        // 强制加载驱动类
        try {
            Class.forName(driverClassName);
        } catch (ClassNotFoundException e) {
            throw new RuntimeException("数据库驱动类加载失败", e);
        }

        while (!connected) {
            try (Connection conn = DriverManager.getConnection(url, username, password)) {
                if (conn.isValid(1000)) {
                    log.info("数据库连接成功，继续启动应用");
                    connected = true;
                }
            } catch (SQLException e) {
                log.warn("数据库连接失败，{}毫秒后重试...", RETRY_INTERVAL, e);
                try {
                    Thread.sleep(RETRY_INTERVAL);
                } catch (InterruptedException ie) {
                    Thread.currentThread().interrupt();
                    throw new RuntimeException("数据库连接检查被中断", ie);
                }
            }
        }
    }
}

这个类会在应用刚启动时就执行，循环尝试连接数据库，直到成功才会继续后续的启动流程，完全避免了启动阶段因数据库未就绪导致的退出问题。

虽然你希望应用自身处理，但可以搭配Docker Compose的healthcheck配置，让容器层面也等待数据库就绪，和应用自身的重试形成双重保障：

version: '3.8'
services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: your_db
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 2s
      timeout: 5s
      retries: 10
  app:
    build: .
    depends_on:
      db:
        condition: service_healthy

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