Docker部署CosmosDB模拟器：调用MongoDB API时触发TimeoutException

核心问题分析 #

你的docker-compose.yml里的command配置会覆盖Cosmos模拟器启动脚本的执行逻辑，导致实际启动的是原生mongod而非Cosmos模拟器的Mongo兼容端点，这是连接失败的主要原因。此外，SSL证书信任问题也会加剧连接异常。

具体修复步骤 #

1. 修正Docker Compose配置 #

删除command: ["mongod", "--port", "10255"]这一行，因为entrypoint指定的start.sh脚本已经负责启动Mongo兼容端点，额外的command会覆盖脚本执行逻辑。同时清理无用的卷定义，调整后的完整配置如下：

version: '2.4'

services:
  cosmosdb:
    container_name: "azurecosmosemulator"
    hostname: "azurecosmosemulator"
    image: 'mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator'
    environment:
        - AZURE_COSMOS_EMULATOR_PARTITION_COUNT=5
        - AZURE_COSMOS_EMULATOR_ENABLE_DATA_PERSISTENCE=true
        - ENABLE_MONGODB_ENDPOINT=4.0
        - AZURE_COSMOS_EMULATOR_IP_ADDRESS_OVERRIDE=172.22.224.1
    tty: true
    mem_limit: 3GB
    ports:
        - '8081:8081'
        - '10255:10255'
    entrypoint: 
        - /usr/local/bin/cosmos/start.sh
        - EnableMongoDbEndpoint=4.0
        - MongoPort=10255
        - AllowNetworkAccess
        - Key=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
        - NoFirewall
    volumes:
        - vol_cosmos:/usr/share/cosmosdbemulator/data
volumes:
  vol_cosmos:
    driver: local

2. 重启Cosmos模拟器容器 #

执行以下命令重新部署容器，确保配置生效：

docker-compose -f docker-compose.yml -p cosmosdb down
docker-compose -f docker-compose.yml -p cosmosdb up -d

等待容器完全启动，可通过docker logs azurecosmosemulator查看日志，确认出现MongoDB endpoint is running on port 10255字样后再进行后续操作。

3. 处理SSL证书验证问题 #

Cosmos模拟器使用自签名SSL证书，.NET客户端默认会验证证书有效性，导致连接失败，可选择以下两种方式处理：

• 方式一：禁用证书验证（仅开发环境使用）
  修改连接字符串，添加sslVerifyCertificate=false参数：

  mongodb://localhost:C2y6yDjf5%2FR%2Bob0N8A7Cgv30VRDJIWEHLM%2B4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw%2FJw%3D%3D@localhost:10255/admin?ssl=true&sslVerifyCertificate=false
  

• 方式二：信任模拟器证书
  从容器导出证书并安装到本地信任存储：
  1. 复制容器内的证书到本地：

     docker cp azurecosmosemulator:/usr/share/cosmosdbemulator/certificates/cosmosemulator.crt ./cosmosemulator.crt
     

  2. 将证书安装到本地系统的受信任根证书颁发机构（具体步骤根据Windows/macOS/Linux系统不同自行操作）。

4. 验证连接 #

重新运行你的.NET Core代码，确认可以正常插入数据。如果仍有问题，检查：

• 本地10255端口是否被其他进程占用（Windows用netstat -ano | findstr :10255，macOS/Linux用lsof -i :10255查看）。
• 容器日志是否有异常报错，确认Mongo端点正常启动。

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