Spring Boot 连接 Docker 中 MongoDB 的完整配置指南

本文详解 spring boot 项目如何正确连接 docker 启动的 mongodb 实例，解决 `datasourcebeancreationexception: failed to determine a suitable driver class` 错误，关键在于禁用 jpa 自动配置、使用正确的 mongodb 属性命名，并移除冗余数据源依赖。

该错误看似与 MongoDB 相关，实则源于 Spring Boot 的自动配置冲突：你同时引入了 spring-boot-starter-data-jpa（面向关系型数据库）和 spring-boot-starter-data-mongodb（面向文档数据库），而 Spring Boot 在启动时会尝试自动配置一个 DataSource（JDBC 数据源），但 MongoDB 并不需要 JDBC 驱动或 DataSource——它使用原生 MongoDB Java Driver 和 MongoClient。因此，当 Spring Boot 发现 spring.datasource.* 类属性缺失（或未正确设置），又找不到嵌入式数据库（如 H2）时，便抛出 Failed to determine a suitable driver class。

✅ 正确做法：彻底分离关注点

1. 移除无关依赖（关键！）

在 pom.xml 中删除 spring-boot-starter-data-jpa —— 它完全不适用于 MongoDB：

    org.springframework.boot
    spring-boot-starter-data-jpa
    ${spring.boot.version}

保留且仅需以下核心依赖：

    org.springframework.boot
    spring-boot-starter-data-mongodb


    org.springframework.boot
    spring-boot-starter-web

? 注：Spring Boot 2.6+ 已内置 mongo-java-driver（通过 spring-boot-starter-data-mongodb 传递依赖），无需手动添加 mongo-java-driver；额外引入反而可能引发版本冲突（如 3.x 驱动与 Spring Data MongoDB 3.3+ 不兼容）。现代推荐使用 mongodb-driver-sync（由 starter 自动管理）。

2. 使用正确的配置属性（application.properties）

MongoDB 的配置*不使用 `spring.datasource.前缀**（那是给 JDBC 用的），而应使用spring.data.mongodb.*` 或更推荐的统一 URI 方式：

✅ 推荐方式（清晰、安全、支持认证）：

# 使用标准 MongoDB 连接 URI（包含认证信息）
spring.data.mongodb.uri=mongodb://root:pass@localhost:27017/proxy_db?authSource=admin

# 可选：显式指定数据库名（若 URI 中已含，此项可省略）
spring.data.mongodb.database=proxy_db

⚠️ 注意事项：

Cutout.Pro

AI驱动的视觉设计平台

下载

• authSource=admin 是必需的：因为你在 docker run 中使用了 MONGO_INITDB_ROOT_USERNAME，该用户属于 admin 数据库；
• 若省略 authSource，MongoDB 默认在目标库（proxy_db）中查找用户，导致认证失败；
• localhost 指宿主机；Docker 容器内运行 Spring Boot 时，需改用 host.docker.internal（macOS/Windows）或宿主 IP（Linux）。

❌ 错误示例（导致报错根源）：

# ❌ 这是 JDBC 配置格式，MongoDB 不识别，且触发 DataSource 自动配置
spring.datasource.url=...
spring.datasource.username=...
# ❌ 更错误：MongoDB 没有 "driver-class-name=com.mongodb.Mongo"（该类已废弃多年）
spring.datasource.driver-class-name=com.mongodb.Mongo

3. （可选）禁用 DataSource 自动配置（双重保险）

若仍担心 JPA 相关组件干扰，可在启动类上显式排除：

@SpringBootApplication(exclude = {
    DataSourceAutoConfiguration.class,
    DataSourceTransactionManagerAutoConfiguration.class,
    JdbcTemplateAutoConfiguration.class
})
public class CrudApplication {
    public static void main(String[] args) {
        SpringApplication.run(CrudApplication.class, args);
    }
}

4. 验证 MongoDB 容器连通性

确保容器正常运行并开放端口：

# 查看容器状态
docker ps | grep mongodb

# 测试本地连接（需安装 mongo shell 或 mongosh）
mongosh "mongodb://root:pass@localhost:27017/proxy_db?authSource=admin"

✅ 成功连接后，再启动 Spring Boot 应用即可看到日志：Connected to MongoDB server，且无 DataSource 相关警告。

总结

遵循以上步骤，你的 Spring Boot 应用将稳定、高效地连接 Docker 中的 MongoDB，彻底告别 DataSourceBeanCreationException。