Docker容器内Mongoose连接MongoDB认证失败问题排查

问题重现 #

使用Mongo Docker镜像配合Mongoose作为对象文档映射器，连接Docker Compose构建的MongoDB容器时，始终抛出认证失败错误：

error: Failed to establish MongoDB connection: MongoServerError: Authentication failed..

但以下场景可正常连接：

• 连接字符串省略凭证、无需认证时
• 连接字符串不带数据库名时
• 使用MongoDB Atlas仅通过URI（不带数据库名）连接时

相关配置与代码如下：

.env文件 #

PORT=3001
MONGO_URI=mongodb://root:toor@mongodb:27017/auth
DB_NAME=auth

Mongoose连接代码 #

await mongoose.connect(`${process.env.MONGO_URI}/${process.env.DB_NAME}`, {
  // 其他配置项
});

Docker Compose配置 #

version: "3"
services: 
  server: 
    build: 
      context: ./server
      dockerfile: ./Dockerfile
    ports: 
      - 3001:3001
    volumes: 
      - ./server/dist:/home/nodeUser/app/dist
    depends_on: 
      - mongodb
  mongodb: 
    image: mongo
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: toor
      MONGO_INITDB_DATABASE: auth
    ports:
      - 27017:27017

问题原因 #

你的MONGO_URI已经包含了数据库名auth（mongodb://root:toor@mongodb:27017/auth），但代码中又额外拼接了一次DB_NAME=auth，最终生成的连接字符串变成了无效格式：

mongodb://root:toor@mongodb:27017/auth/auth

这种重复的数据库路径导致MongoDB认证逻辑异常，从而抛出认证失败错误。

另外需要注意：MongoDB的root用户默认创建在admin数据库下，即使设置了MONGO_INITDB_DATABASE=auth，root用户仍需先在admin库完成认证，才能访问其他数据库。不过此次问题的核心是连接字符串的重复拼接。

解决方案 #

两种修复方式任选其一即可：

方案1：修改.env文件，移除URI中的数据库名 #

将.env里的MONGO_URI改为不带数据库名的格式，保留代码中的拼接逻辑：

MONGO_URI=mongodb://root:toor@mongodb:27017
DB_NAME=auth

此时生成的连接字符串为mongodb://root:toor@mongodb:27017/auth，是正确的格式。

方案2：直接使用完整URI，不额外拼接数据库名 #

保持.env的MONGO_URI不变，修改Mongoose连接代码，不再拼接DB_NAME：

await mongoose.connect(process.env.MONGO_URI, {
  // 其他配置项
});

也可以在连接配置中显式指定数据库名（可选）：

await mongoose.connect(process.env.MONGO_URI, {
  dbName: process.env.DB_NAME,
  // 其他配置项
});

额外验证 #

如果仍存在认证问题，可尝试在连接配置中指定认证数据库为admin（因为root用户归属admin库）：

await mongoose.connect(process.env.MONGO_URI, {
  authSource: 'admin',
  // 其他配置项
});

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