Spring Boot中如何解决'mongoDatabaseFactory'抛出的数据库名不能为空错误？

错误详情 #

Error creating bean with name 'mongoDatabaseFactory' defined in class path resource. Failed to instantiate [org.springframework.data.mongodb.core.MongoDatabaseFactorySupport]: Factory method 'mongoDatabaseFactory' threw exception with message: Database name must not be empty

已做前置排查 #

• 已在application.properties中配置数据库名称
• MongoDB服务处于运行状态

针对性排查解决方案 #

1. 核对配置键名与格式 #

Spring Boot不同版本的MongoDB配置需匹配对应键：

• 无论2.x还是3.x版本，核心数据库名配置键为spring.data.mongodb.database=你的数据库名
• 若使用URI连接方式，必须在URI末尾指定数据库名，例如：spring.data.mongodb.uri=mongodb://localhost:27017/你的数据库名，不能只写mongodb://localhost:27017/

2. 确认配置文件加载有效性 #

• 检查application.properties是否放在src/main/resources目录下，位置错误会导致配置不生效
• 若使用多环境配置，确认spring.profiles.active指定的是你配置了数据库名的环境
• 启动时查看日志，搜索Loaded config file相关内容，验证配置文件是否被成功读取

3. 排查配置覆盖情况 #

• 检查是否存在系统环境变量、启动命令行参数覆盖了数据库名配置（例如启动时传入--spring.data.mongodb.database=空值）
• 检查代码中是否有自定义MongoClient或MongoDatabaseFactory的Bean，硬编码的配置会覆盖配置文件内容

4. 验证依赖版本兼容性 #

确保Spring Boot与Spring Data MongoDB版本匹配，推荐使用Spring Boot的依赖管理插件（Maven的spring-boot-starter-parent或Gradle的io.spring.dependency-management）统一管理版本，避免版本不兼容导致的配置读取异常

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