Spring Boot数据库连接出错时，如何实现自动重试机制？

在Spring Boot里配置数据库连接重试，主要可以通过连接池原生配置和Spring Retry增强重试两种方式实现，下面是具体步骤：

1. 引入必要依赖 #

如果要用到Spring Retry做灵活的重试控制，需要先添加依赖：

Maven（pom.xml） #

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

Gradle（build.gradle） #

implementation 'org.springframework.retry:spring-retry'
implementation 'org.springframework.boot:spring-boot-starter-aop'

2. 配置连接池原生重试（以默认HikariCP为例） #

Spring Boot默认用HikariCP连接池，它本身提供了连接重试相关参数，直接在配置文件中设置即可：

application.yml 配置示例 #

spring:
  datasource:
    url: jdbc:mysql://your-db-host:3306/your-db?useSSL=false&serverTimezone=UTC
    username: db-user
    password: db-pass
    hikari:
      # 连接超时时间，单位毫秒
      connection-timeout: 30000
      # 初始化连接池时的失败超时时间：设为-1则无限重试直到成功；正数则等待对应时长后放弃；0则直接失败
      initialization-fail-timeout: -1
      # 连接有效性检测SQL，确保获取的连接可用
      connection-test-query: SELECT 1
      # 连接最大生命周期，到期自动销毁重建
      max-lifetime: 1800000
      # 连接有效性检测超时时间
      validation-timeout: 5000

3. 用Spring Retry实现业务/数据层的精细化重试 #

如果需要在运行时（比如DAO操作时连接失败）做自定义重试逻辑，可以用Spring Retry：

第一步：启用重试功能 #

在Spring Boot启动类上添加@EnableRetry注解：

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

第二步：给目标方法添加重试注解 #

在需要重试的方法（比如DAO的查询/更新方法，或者自定义的数据源初始化方法）上添加@Retryable注解，指定触发重试的异常、重试次数、间隔等：

@Repository
public class YourDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    // 当出现数据库连接相关异常时，重试3次，每次间隔1秒
    @Retryable(value = {CannotGetJdbcConnectionException.class, SQLException.class},
               maxAttempts = 3,
               backoff = @Backoff(delay = 1000))
    public List<YourEntity> queryData() {
        return jdbcTemplate.query("SELECT * FROM your_table", new BeanPropertyRowMapper<>(YourEntity.class));
    }

    // 重试失败后的恢复方法，参数要和重试方法一致，最后加上Throwable
    @Recover
    public List<YourEntity> recoverQueryData(CannotGetJdbcConnectionException e) {
        // 重试失败后的处理逻辑，比如返回空列表、记录告警等
        log.error("数据库连接重试多次失败，执行降级逻辑", e);
        return Collections.emptyList();
    }
}

4. 关键注意事项 #

• 区分初始化重试和运行时重试：连接池的initialization-fail-timeout控制启动时的连接重试，Spring Retry控制运行时方法调用的重试
• 避免无限重试：如果用initialization-fail-timeout=-1，要确保数据库最终能恢复，否则应用会一直卡在启动阶段；运行时重试也要合理设置maxAttempts
• 确保重试方法幂等：如果是写操作，重试可能导致重复数据，要保证方法是幂等的（比如用唯一主键、乐观锁等）

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