本地MongoDB正常，Spring Boot连接AWS上MongoDB Atlas报错

问题场景 #

使用JDK17 + SpringBoot3.0.1开发，本地MongoDB连接正常，但通过application.properties配置spring.data.mongodb.uri连接AWS上的MongoDB Atlas集群时，应用启动失败，核心报错为：Database name must not be empty。

原因分析 #

1. MongoDB URI格式不完整：Atlas提供的连接URI必须包含指定的数据库名称，若URI中遗漏<databaseName>部分，SpringBoot无法识别要连接的数据库，触发该错误。
2. 配置项冲突：同时配置spring.data.mongodb.uri和spring.data.mongodb.database，导致SpringBoot解析连接参数时出现冲突，无法正确获取数据库名。
3. 特殊字符未编码：URI中的密码若包含@、&等特殊字符，未进行URL编码会导致URI解析失败，间接引发数据库名识别异常。

解决方案 #

1. 修正MongoDB URI格式 #

确保URI包含明确的数据库名称，正确格式示例：

spring.data.mongodb.uri=mongodb+srv://your-username:your-password@cluster0.mongodb.net/your-db-name?retryWrites=true&w=majority

其中your-db-name为你要连接的数据库名称，不可省略。

2. 移除冲突配置项 #

若配置文件中同时存在spring.data.mongodb.database，请删除该配置项，避免与URI中的数据库名定义冲突。

3. 处理URI中的特殊字符 #

如果密码包含特殊字符，需进行URL编码：

• @ → %40
• & → %26
• # → %23
  示例：原密码为pass@123，编码后URI为：

spring.data.mongodb.uri=mongodb+srv://user:pass%40123@cluster0.mongodb.net/mydb?retryWrites=true&w=majority

4. 验证URI有效性 #

先用MongoDB Compass测试修正后的URI是否能正常连接Atlas集群，确认连接正常后再复制到配置文件中。

代码层面检查（针对你的Repo/Model类） #

确保Repo接口继承MongoRepository时，实体类的@Document注解未错误覆盖数据库配置：

// 实体类示例
@Document(collection = "users") // 仅指定集合名，数据库名由URI提供
public class User {
    @Id
    private String id;
    private String name;
    // getter/setter
}

// Repo接口示例
public interface UserRepo extends MongoRepository<User, String> {
}

无需在@Document中指定database属性，避免与URI配置冲突。

验证 #

修改配置后重启应用，若启动成功且能正常操作Atlas集群中的数据，则问题解决。

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