.NET 7 Core应用连接Docker中MongoDB容器认证失败求助

我在.NET Core WebAPI微服务架构中，通过Docker Compose部署了Postgres和MongoDB服务，Docker Compose配置如下：

version: '3'
services:
  postgres:
    ports:
      - '5433:5432'
    container_name: container-postgresql
    environment:
      - POSTGRES_PASSWORD=mypass
    volumes:
      - 'container-postgresql-volume:/var/lib/postgresql/data'
    image: 'postgres:10.4'
    networks:
      - container-network
  mongodb:
    image: mongo
    environment:
      - MONGO_INIT_DB_ROOT_USERNAME=root
      - MONGO_INIT_DB_ROOT_PASSWORD=mypass 
    ports:
      - 27017:27017
    volumes:
      - mongodata:/var/lib/mongodb/data
    networks:
      - container-network

volumes:
  container-postgresql-volume:
  mongodata:
networks:
  container-network:
    driver: bridge

appsetting.Development.json中的MongoDB连接字符串配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Information"
    }
  },
 "ConnectionStrings": {
    "DefaultConnection": "mongodb://root:mypass@localhost:27017/?authSource=admin"
 }
}

运行应用时抛出认证错误：

Unhandled exception. MongoDB.Driver.MongoAuthenticationException: Unable to authenticate using sasl protocol mechanism SCRAM-SHA-1.
---> MongoDB.Driver.MongoCommandException: Command saslStart failed: Authentication failed..

已尝试修改连接字符串、重启/重建容器、配置防火墙、删除卷和网桥重建、重启系统，均未解决问题。

以下是针对性的排查和修复步骤：

1. 验证MongoDB容器内用户初始化状态 #

进入MongoDB容器手动验证管理员账号：

docker exec -it <mongodb-container-name> mongosh -u root -p mypass --authenticationDatabase admin

若登录失败，说明账号初始化异常，需彻底清理MongoDB持久化卷后重建：

# 查看所有卷找到目标MongoDB卷
docker volume ls
# 删除对应卷
docker volume rm <your-project-name>_mongodata
# 强制重建MongoDB容器
docker-compose up -d --force-recreate mongodb

注：<your-project-name>为docker-compose所在目录名称。

2. 优化连接字符串配置 #

• 若密码含@、:等特殊字符，需做URL编码（如@替换为%40）
• 显式指定认证机制，避免版本兼容问题：

  "DefaultConnection": "mongodb://root:mypass@localhost:27017/?authSource=admin&authMechanism=SCRAM-SHA-256"
  

3. 升级MongoDB驱动版本 #

低版本MongoDB.Driver可能与最新MongoDB容器存在认证机制兼容问题，通过NuGet升级到稳定最新版：

Install-Package MongoDB.Driver -Version 2.22.0

或直接修改项目.csproj文件中的驱动版本号。

4. 检查网络访问路径 #

• 若WebAPI也部署在Docker容器中，连接字符串需将localhost替换为MongoDB服务名mongodb：

  "DefaultConnection": "mongodb://root:mypass@mongodb:27017/?authSource=admin"
  

• 本地运行WebAPI可尝试用容器IP替代localhost，获取IP命令：

  docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <mongodb-container-name>
  

5. 排查容器日志 #

查看MongoDB启动日志，确认初始化阶段是否有用户创建错误：

docker logs <mongodb-container-name>

若日志显示用户创建失败，可尝试指定MongoDB镜像版本（如mongo:5.0）或检查卷权限配置。

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