如何使SpringBoot v2.7.0应用在MongoDB宕机时仍可正常启动？

1. 调整MongoDB连接配置，避免启动阻塞 #

修改你的application.yml，添加连接超时、禁用重试等属性，让应用快速判断MongoDB状态，避免启动时长时间阻塞：

spring:
  data:
    mongodb:
      uri: ${MONGO_DB_URL}
      database: ${MONGO_DB_DATABASE}
      connect-timeout: 1000  # 缩短连接超时时间，快速识别连接失败
      socket-timeout: 1000
      client:
        retry:
          max-attempts: 0  # 关闭启动阶段的自动重试
      auto-index-creation: false  # 禁止启动时自动创建索引，减少对MongoDB的依赖

2. 延迟初始化Mongo相关Bean #

通过延迟初始化，让MongoClient、MongoTemplate及Repository在启动阶段不尝试连接MongoDB，直到第一次业务调用时才建立连接：

方式一：全局延迟初始化（简单但影响范围广） #

在application.yml中添加全局配置：

spring:
  main:
    lazy-initialization: true

方式二：精准延迟Mongo相关Bean（推荐） #

创建自定义配置类，仅对Mongo相关组件做延迟初始化：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Lazy;
import org.springframework.data.mongodb.MongoDatabaseFactory;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;

@Configuration
@EnableMongoRepositories(basePackages = "com.yourpackage.repository") // 替换为你的Repository实际包路径
public class MongoLazyConfig {

    @Bean
    @Lazy
    public MongoTemplate mongoTemplate(MongoDatabaseFactory databaseFactory) {
        return new MongoTemplate(databaseFactory);
    }
}

3. 业务层添加降级逻辑 #

MongoDB宕机时，第一次调用Repository会抛出连接异常，需在业务代码中捕获并处理，保证核心流程不受影响：

@Service
public class YourBizService {

    private final YourMongoRepository mongoRepository;

    public YourBizService(YourMongoRepository mongoRepository) {
        this.mongoRepository = mongoRepository;
    }

    public List<YourModel> queryData() {
        try {
            return mongoRepository.findAll();
        } catch (Exception e) {
            // 降级逻辑：返回空列表、读取本地缓存或默认数据
            return Collections.emptyList();
        }
    }
}

4. 自定义容错MongoClient（可选） #

如果以上配置仍无法满足需求，可以排除默认Mongo自动配置，自定义容错的MongoClient：

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Primary;
import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;

@Configuration
@EnableMongoRepositories(basePackages = "com.yourpackage.repository")
public class MongoFaultTolerantConfig {

    @Bean
    @Primary
    public MongoClient mongoClient() {
        try {
            return MongoClients.create(System.getenv("MONGO_DB_URL"));
        } catch (Exception e) {
            // 连接失败时返回占位Client，实际调用需配合业务层降级
            return MongoClients.create("mongodb://localhost:27017");
        }
    }
}

同时在application.yml中排除默认自动配置：

spring:
  autoconfigure:
    exclude:
      - org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration
      - org.springframework.boot.autoconfigure.mongo.MongoDataAutoConfiguration

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