Docker Compose创建MongoDB用户失败，Node.js容器无法连接

核心问题分析 #

• 容器启动时序不匹配：depends_on仅保证MongoDB容器先启动，但不确保MongoDB服务完成初始化（包括用户创建流程），Node.js启动时MongoDB可能仍在准备阶段，直接发起连接会失败。
• Root用户认证库错误：MONGO_INITDB_ROOT_USERNAME创建的是MongoDB超级管理员用户，该用户的默认认证数据库是admin，而非你指定的mydb，未指定认证库会导致身份验证失败。

解决方案 #

方案1：调整连接字符串，指定认证库 #

修改Node.js的连接URL，显式指定root用户的认证数据库为admin，验证通过后再操作mydb：

const url = "mongodb://myuser:mypassword@mongodb:27017/mydb?authSource=admin";

方案2：创建mydb专用用户（更安全） #

避免用root用户连接业务应用，通过初始化脚本创建数据库专用用户：

1. 项目根目录创建mongo-init.js：

db.createUser({
  user: "appuser",
  pwd: "apppassword",
  roles: [{ role: "readWrite", db: "mydb" }]
});

2. 修改docker-compose.yml，挂载初始化脚本到MongoDB的自动执行目录：

version: '3.1'

services:
  mongodb:
    image: mongo
    environment:
      MONGO_INITDB_ROOT_USERNAME: myuser
      MONGO_INITDB_ROOT_PASSWORD: mypassword
      MONGO_INITDB_DATABASE: mydb
    volumes:
      - ./mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js
    ports:
      - "27017:27017"

  nodejs:
    build: .
    depends_on:
      - mongodb

3. 更新Node.js连接URL为专用用户：

const url = "mongodb://appuser:apppassword@mongodb:27017/mydb";

方案3：优化重试逻辑，适配服务就绪状态 #

增强现有重试逻辑，区分网络错误与认证错误，更精准处理连接等待：

function connectWithRetry() {
  MongoClient.connect(url, {}, function(err, db) {
    if (err) {
      if (err.name === 'MongoNetworkError') {
        console.error('MongoDB服务未就绪，5秒后重试');
      } else {
        console.error('MongoDB连接失败:', err.message);
      }
      setTimeout(connectWithRetry, 5000);
    } else {
      var dbo = db.db("mydb");
      var myobj = { name: "John Doe", address: "Highway 37" };
      
      dbo.collection("users").insertOne(myobj, function(err, res) {
        if (err) throw err;
        console.log("1条数据插入成功");
        
        dbo.collection("users").findOne({}, function(err, result) {
          if (err) throw err;
          console.log(result.name);
          db.close();
        });
      });
    }
  });
}

方案4：用环境变量管理认证信息（符合你的需求） #

避免硬编码账号密码，通过.env文件统一管理：

1. 创建.env文件：

MONGO_USER=appuser
MONGO_PASSWORD=apppassword
MONGO_DB=mydb
MONGO_HOST=mongodb

2. 修改docker-compose.yml引入环境变量：

version: '3.1'

services:
  mongodb:
    image: mongo
    environment:
      MONGO_INITDB_ROOT_USERNAME: myuser
      MONGO_INITDB_ROOT_PASSWORD: mypassword
      MONGO_INITDB_DATABASE: ${MONGO_DB}
    volumes:
      - ./mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js
    ports:
      - "27017:27017"

  nodejs:
    build: .
    depends_on:
      - mongodb
    environment:
      MONGO_USER: ${MONGO_USER}
      MONGO_PASSWORD: ${MONGO_PASSWORD}
      MONGO_DB: ${MONGO_DB}
      MONGO_HOST: ${MONGO_HOST}

3. Node.js代码读取环境变量：

const MongoClient = require('mongodb').MongoClient;
const { MONGO_USER, MONGO_PASSWORD, MONGO_HOST, MONGO_DB } = process.env;
const url = `mongodb://${MONGO_USER}:${MONGO_PASSWORD}@${MONGO_HOST}:27017/${MONGO_DB}`;

connectWithRetry();

验证步骤 #

1. 清理现有容器与数据卷：docker-compose down -v
2. 重新构建并启动容器：docker-compose up --build
3. 查看日志，确认MongoDB初始化完成，Node.js成功连接并执行数据操作。

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