无法禁用Spring Boot自动连接本地Mongo的问题排查

1. 补全自动配置排除项 #

你当前仅排除了MongoAutoConfiguration和MongoDataAutoConfiguration，如果项目中引入了反应式MongoDB依赖（如spring-boot-starter-data-mongodb-reactive），还需要额外排除相关反应式自动配置类：

@SpringBootApplication(exclude = {
    MongoAutoConfiguration.class,
    MongoDataAutoConfiguration.class,
    MongoReactiveAutoConfiguration.class,
    MongoReactiveDataAutoConfiguration.class
})

2. 检查自定义Mongo客户端配置 #

确认你手动创建的MongoClient/MongoTemplate Bean完全使用Atlas连接信息，避免无参构造触发默认本地连接：

@Bean
public MongoClient mongoClient(MongoProperties properties) {
    // 直接复用配置文件中的uri，不要手动拼接或使用无参构造
    return MongoClients.create(properties.getUri());
}

@Bean
public MongoTemplate mongoTemplate(MongoClient mongoClient) {
    return new MongoTemplate(mongoClient, "你的数据库名称");
}

3. 排查依赖引发的隐式初始化 #

通过Spring Boot debug模式查看自动配置激活情况，确认是否有未被排除的Mongo相关配置类在运行：

mvn spring-boot:run -Ddebug

在输出中搜索Mongo关键词，检查是否有意外生效的自动配置项。同时排查pom.xml，确认没有引入会自动初始化本地Mongo的依赖（如embedded-mongo测试组件）。

4. 验证配置文件优先级 #

确保application.properties中的Atlas配置未被覆盖：

• 保留核心配置项，删除spring.data.mongodb.host、spring.data.mongodb.port这类会覆盖uri的本地配置
• 确认配置的连接字符串格式正确：

spring.data.mongodb.uri=mongodb+srv://<用户名>:<密码>@cluster0.mongodb.net/<数据库名>?retryWrites=true&w=majority

5. 全局检查硬编码连接 #

搜索代码库中的localhost:27017、127.0.0.1:27017，确认自定义工具类、测试代码中没有硬编码本地Mongo连接。

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