MongoDB容器认证失败：凭据正确仍无法连接Node.js后端

本地测试时，Node.js后端使用Mongoose连接本地MongoDB容器，控制台打印的凭据与容器初始化环境变量一致，但仍出现MongoServerError: Authentication failed错误，可按以下方向排查：

• 清理旧容器，确保初始化凭据生效
  你的启动命令docker start mongo || docker run...存在复用旧容器的风险：如果之前有未正确初始化凭据的mongo容器，docker start会直接启动旧容器，而旧容器不会重新执行初始化环境变量逻辑。解决步骤：

  1. 停止并删除旧容器：

     docker stop mongo && docker rm mongo
     

  2. 重新执行容器创建命令，确保容器是全新初始化的。

• 验证容器内MongoDB的实际认证配置
  MongoDB的root用户默认创建在admin数据库下，而非你指定的concept_slide数据库。直接进入容器验证凭据有效性：

  docker exec -it mongo mongosh -u fares -p password --authenticationDatabase admin
  

  若能成功登录，说明凭据本身无问题；若登录失败，说明容器初始化时环境变量未正确生效，需检查变量传递逻辑。

• 修正Mongoose连接的认证源配置
  当前代码默认使用concept_slide数据库作为认证源，但root用户归属admin库，必须显式指定authSource选项：

  export const connectMongoDB = () => {
    console.log({
      user: process.env.MONGODB_USER,
      pass: process.env.MONGODB_PASSWORD,
    });
    mongoose.connect(`mongodb://${process.env.MONGODB_TEST_HOSTNAME}:27017/concept_slide`, {
      user: process.env.MONGODB_USER,
      pass: process.env.MONGODB_PASSWORD,
      authSource: 'admin', // 关键：指定认证数据库为admin
    });
  
    mongoose.connection
      .on('connected', () => {
        console.log('Local database connected');
      })
      .on('error', (err) => {
        console.error(
          'Local database unreachable. Please check database or network access. Error: ',
          err
        );
      });
  };
  

  另外，连接选项中的hostname是冗余配置，Mongoose会从连接字符串中解析主机地址，可直接移除。

• 确认容器启动时环境变量的实际传递
  检查容器内的环境变量是否正确：

  docker exec mongo env | grep MONGO_INITDB
  

  若输出的MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD与预期不符，说明启动命令中的环境变量未正确展开。可尝试直接替换变量为具体值测试：

  docker run --rm --name mongo -e MONGO_INITDB_ROOT_USERNAME="fares" -e MONGO_INITDB_ROOT_PASSWORD="password" -e MONGO_INITDB_DATABASE="concept_slide" -p 27017:27017 -d mongo:latest
  

• 检查Mongoose与MongoDB版本兼容性
  不同版本的MongoDB和Mongoose可能存在认证机制差异（比如MongoDB 6.x默认使用SCRAM-SHA-256，旧版Mongoose可能需要显式指定）。可尝试在连接选项中添加认证机制：

  mongoose.connect(..., {
    // 其他选项
    authMechanism: 'SCRAM-SHA-256' // 或根据MongoDB版本调整为SCRAM-SHA-1
  });
  

  同时确认Mongoose版本是否适配当前MongoDB容器版本（比如Mongoose 6.x+支持MongoDB 5.x/6.x）。

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