Docker环境下带用户名密码的Spring Boot容器与Mongo容器连接最佳方案

我来分享下在Docker环境里让带用户名密码认证的Mongo容器和Spring Boot容器顺畅连接的最佳实践，都是实际项目里验证过的方案，踩过的坑也给你列出来：

Mongo容器的用户认证最好在启动时就初始化好，不要事后手动创建，这样更可控。

• 用环境变量快速初始化：如果是单实例Mongo，直接用官方镜像的环境变量就能创建 root 用户和密码：

  # docker-compose.yml里的Mongo配置
  services:
    mongo-db:
      image: mongo:latest
      environment:
        - MONGO_INITDB_ROOT_USERNAME=admin
        - MONGO_INITDB_ROOT_PASSWORD=yourStrongPassword123
        - MONGO_INITDB_DATABASE=myapp_db
      volumes:
        - mongo-data:/data/db
      networks:
        - app-network
  

  这里MONGO_INITDB_DATABASE会自动创建指定的库，避免后续Spring Boot连接时报错。

• 自定义初始化脚本（多用户/权限场景）：如果需要给不同业务库创建独立用户，挂载一个初始化脚本到容器的/docker-entrypoint-initdb.d/目录，Mongo启动时会自动执行：
  比如创建init-mongo.js：

  db = db.getSiblingDB('myapp_db');
  db.createUser({
    user: 'app_user',
    pwd: 'appUserPassword456',
    roles: [{ role: 'readWrite', db: 'myapp_db' }]
  });
  

  然后在docker-compose里挂载：

  volumes:
    - ./init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js:ro
    - mongo-data:/data/db
  

Spring Boot这边要灵活配置，避免硬编码，优先用环境变量注入：

• 方式一：用完整的Mongo URI
  在application.yml里配置：

  spring:
    data:
      mongodb:
        uri: mongodb://${MONGO_USERNAME:app_user}:${MONGO_PASSWORD:appUserPassword456}@${MONGO_HOST:mongo-db}:${MONGO_PORT:27017}/${MONGO_DB:myapp_db}?authSource=admin
  

  这里的authSource很重要！如果你的用户是在admin库创建的（比如用root用户初始化的），必须指定authSource=admin，不然Mongo会默认在目标库找用户，导致认证失败——这是我踩过的大坑！

• 方式二：分开配置参数
  如果觉得URI太长，也可以拆分配置：

  spring:
    data:
      mongodb:
        host: ${MONGO_HOST:mongo-db}
        port: ${MONGO_PORT:27017}
        database: ${MONGO_DB:myapp_db}
        username: ${MONGO_USERNAME:app_user}
        password: ${MONGO_PASSWORD:appUserPassword456}
        authentication-database: admin
  

  这里authentication-database就是指定认证用的库，和URI里的authSource对应。

Docker容器之间的连接，一定要用自定义网络，别用默认的bridge网络，原因是默认网络的容器名解析不稳定，自定义网络是Docker推荐的方式：

• 用Docker Compose自动创建网络：如果用docker-compose，只要在文件里定义networks，所有services会自动加入这个网络，容器之间可以直接用容器名（比如上面的mongo-db）作为主机名访问，不用记IP：

  networks:
    app-network:
      driver: bridge
  

• 手动创建网络（不用Compose的情况）：
  先创建网络：

  docker network create app-network
  

  启动Mongo容器时加入这个网络：

  docker run -d --name mongo-db --network app-network -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=xxx mongo:latest
  

  启动Spring Boot容器时也加入同一个网络：

  docker run -d --name spring-boot-app --network app-network -e MONGO_HOST=mongo-db -e MONGO_PASSWORD=xxx your-spring-boot-image:latest
  

• 绝对不要硬编码密码：无论是Spring Boot的配置文件还是Docker命令，都要用环境变量或者Docker Secrets（生产环境推荐）来传递敏感信息。比如生产环境可以用Docker Secrets存储密码，然后在容器里读取：

  # docker-compose.yml里用secrets
  secrets:
    mongo_root_password:
      file: ./mongo_root_password.txt
    app_user_password:
      file: ./app_user_password.txt
  services:
    mongo-db:
      environment:
        - MONGO_INITDB_ROOT_PASSWORD_FILE=/run/secrets/mongo_root_password
      secrets:
        - mongo_root_password
  

• 测试连接的小技巧：可以进入Spring Boot容器，用mongosh命令测试连接是否正常：

  docker exec -it spring-boot-app mongosh mongodb://app_user:appUserPassword456@mongo-db:27017/myapp_db?authSource=admin
  

  如果能成功进入Mongo shell，说明连接配置没问题。

• 生产环境的额外配置：比如Mongo开启TLS加密，Spring Boot这边也要配置ssl=true，避免明文传输密码，进一步提升安全性。

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