如何配置Spring Data Mongo避免连接默认localhost，仅连接远程MongoDB

问题核心原因 #

Spring Boot默认会加载MongoDB的自动配置，默认参数为127.0.0.1:27017，出现该问题通常是你配置的远程连接参数没有被正确加载，或者被其他配置、自定义Bean覆盖了默认自动配置。

排查与解决步骤 #

1. 校验配置文件的正确性与加载优先级 #

• 确认配置文件放置在src/main/resources目录下，文件名为application.yml/application.properties，且当前激活的profile对应的配置文件（如application-dev.yml）中没有覆盖MongoDB连接参数。
• 不要同时配置uri参数和单独的host/port参数，二者选其一即可，uri优先级更高。
  正确配置示例：
  yml格式

spring:
  data:
    mongodb:
      uri: mongodb://你的用户名:你的密码@远程MongoIP:远程端口/目标数据库名?authSource=admin
      # 拆分配置写法（二选一即可）
      # host: 远程MongoIP
      # port: 远程端口
      # username: 你的用户名
      # password: 你的密码
      # database: 目标数据库名
      # authentication-database: admin

properties格式

spring.data.mongodb.uri=mongodb://你的用户名:你的密码@远程MongoIP:远程端口/目标数据库名?authSource=admin
# 拆分配置写法（二选一即可）
# spring.data.mongodb.host=远程MongoIP
# spring.data.mongodb.port=远程端口
# spring.data.mongodb.username=你的用户名
# spring.data.mongodb.password=你的密码
# spring.data.mongodb.database=目标数据库名
# spring.data.mongodb.authentication-database=admin

2. 排查自定义Bean的硬编码问题 #

• 检查你项目中自定义的MongoClient、MongoTemplateBean，确认没有硬编码写死127.0.0.1:27017的本地连接地址。
• 检查启动类的@EnableMongoRepositories注解，确认没有错误指定自定义配置类。

3. 手动接管MongoDB配置（可选，适用于自动配置不生效的场景） #

如果自动配置始终被覆盖，可以直接关闭MongoDB的默认自动配置，手动注册Bean：
第一步，在启动类排除自动配置：

import org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration;
import org.springframework.boot.autoconfigure.data.mongo.MongoDataAutoConfiguration;

@SpringBootApplication(exclude = {MongoAutoConfiguration.class, MongoDataAutoConfiguration.class})
public class 你的启动类名 {
    public static void main(String[] args) {
        SpringApplication.run(你的启动类名.class, args);
    }
}

第二步，新增自定义Mongo配置类：

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.MongoTemplate;

@Configuration
public class MongoConfig {
    @Value("${spring.data.mongodb.uri}")
    private String mongoUri;

    @Value("${spring.data.mongodb.database}")
    private String dbName;

    @Bean
    public MongoClient mongoClient() {
        return MongoClients.create(mongoUri);
    }

    @Bean
    public MongoTemplate mongoTemplate(MongoClient mongoClient) {
        return new MongoTemplate(mongoClient, dbName);
    }
}

4. 检查依赖正确性 #

确认pom.xml中只引入官方starter，无需额外引入单独的MongoDB驱动，避免版本冲突：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>

验证方法 #

启动时在配置文件添加debug: true，查看控制台输出的MongoDB配置属性的加载来源，确认你填写的远程连接参数已经被正确加载。

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