AWS ECS Fargate单任务中MongoDB认证失败（错误码18）求助

以下是针对你遇到的认证失败问题的逐一排查点和解决办法：

1. 修复环境变量的空格问题 #

你的Node.js容器环境变量定义存在空格：

MONGODB_USERNAME = username
MONGODB_PASSWORD = password

等号两侧的空格会导致process.env.MONGODB_USERNAME实际读取到的值是" username"（包含前导空格），与MongoDB初始化的用户名不匹配，直接引发认证失败。

解决方法：修改环境变量定义，去掉等号两边的空格：

MONGODB_USERNAME=username
MONGODB_PASSWORD=password

2. 确认MongoDB的监听地址配置 #

如果MongoDB仅绑定127.0.0.1，在ECS Fargate的awsvpc网络模式下（同任务容器共享网络栈）虽理论上可通过localhost访问，但存在兼容性风险。建议强制MongoDB监听所有网卡地址。

解决方法：在MongoDB容器的任务定义中，添加启动参数--bind_ip 0.0.0.0，修改后的容器命令示例：

mongod --bind_ip 0.0.0.0

3. 验证MongoDB初始化脚本是否生效 #

MONGO_INITDB_ROOT_USERNAME、MONGO_INITDB_ROOT_PASSWORD这些环境变量仅在MongoDB容器首次启动且数据卷为空时才会执行初始化。如果你的任务复用了已存在的持久化数据卷（如EFS），旧数据卷中的用户信息可能与当前配置不匹配。

排查步骤：

1. 临时修改MongoDB容器命令，进入容器执行以下命令验证用户：

   mongosh -u username -p password --authenticationDatabase admin
   use admin
   db.getUsers()
   

2. 如果未查询到目标用户，说明初始化未执行。

解决方法：

• 删除旧的持久化数据卷，重新启动任务让MongoDB重新初始化用户；
• 若需保留数据卷，手动在MongoDB中创建匹配的用户。

4. 调整容器启动顺序与连接重试逻辑 #

Node.js容器可能在MongoDB完成用户初始化前就发起连接请求，导致认证失败。

解决方法：

• 配置容器依赖与健康检查：在ECS任务定义中，将Node.js容器的dependsOn设置为MongoDB容器，依赖类型选择HEALTHY；同时给MongoDB容器配置健康检查：
  • 健康检查命令：mongosh --eval "db.adminCommand('ping')"
  • 检查间隔：10秒
  • 超时时间：5秒
  • 重试次数：3次
• 添加代码重试逻辑：修改Node.js连接代码，增加自动重试机制：

  const connectWithRetry = () => {
    mongoose.connect(`mongodb://${process.env.MONGODB_USERNAME}:${process.env.MONGODB_PASSWORD}@${process.env.MONGODB_URL}:27017/my-db?authSource=admin`,
      {
        useNewUrlParser: true,
        useUnifiedTopology: true,
      }
    )
    .then(() => {
      console.log('CONNECTED TO MONGODB!!');
      app.listen(80);
    })
    .catch((err) => {
      console.error('FAILED TO CONNECT TO MONGODB, retrying in 5 seconds...');
      console.error(err);
      setTimeout(connectWithRetry, 5000);
    });
  };
  
  connectWithRetry();
  

5. 检查ECS任务的端口配置 #

确保MongoDB容器在任务定义中配置了容器端口27017（awsvpc模式下无需主机端口），如果未配置容器端口，其他容器无法访问该端口服务。

解决方法：在MongoDB容器的端口映射配置中添加容器端口27017，协议选择tcp。

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