Node.js Docker容器连接Azure MongoDB失败排查与解决

以下是针对你的问题的具体排查和解决步骤：

1. 验证网络连通性 #

• 检查Azure IP白名单：确保Docker容器所在主机的公网IP已添加到Azure Cosmos DB的防火墙允许列表中（Azure门户 > Cosmos DB > 防火墙和虚拟网络）。
• 测试容器内网络访问：进入容器内部，执行以下命令测试能否访问Azure MongoDB端点：

  # 测试域名解析
  nslookup your-account-name.mongo.cosmos.azure.com
  # 测试端口连通性（默认10255）
  telnet your-account-name.mongo.cosmos.azure.com 10255
  

• 临时切换Docker网络模式：尝试用host模式启动容器（仅用于测试），排除bridge网络的限制：

  docker run --network host -e MONGO_URL=xxx -e MONGO_NAME=xxx your-app-image
  

2. 确认环境变量正确性 #

• 进入运行中的容器，检查环境变量是否正确传入：

  docker exec -it your-container-id printenv | grep MONGO
  

• 重点验证MONGO_URL是否为Azure提供的完整连接字符串，需包含：
  • ssl=true
  • replicaSet=globaldb
  • retrywrites=false

3. 优化MongoClient连接配置 #

Azure Cosmos DB的Mongo API有特定要求，修改连接代码添加超时和适配配置，避免无响应：

import { MongoClient } from 'mongodb'

const getDb = async() => {
  const dbName = process.env.MONGO_NAME;
  const url = process.env.MONGO_URL;
  let client;
  try {
    client = new MongoClient(url, {
      // 设置连接和socket超时，避免无限等待
      connectTimeoutMS: 10000,
      socketTimeoutMS: 10000,
      // Azure Cosmos DB要求禁用重试写入
      retryWrites: false,
      // 强制启用SSL（连接字符串未指定时补充）
      ssl: true
    });
    console.log('正在连接MongoDB...');
    await client.connect();
    console.log('连接成功');
    const db = client.db(dbName);
    console.log('已选择数据库:', dbName);
    return db;
  } catch (err) {
    console.error('连接失败详情:', err);
    // 出错时关闭客户端
    if (client) await client.close();
    throw err;
  }
}

4. 增强日志排查 #

• 在调用getDb()和后续操作的地方添加日志，确认执行到哪一步卡住：

  console.log('开始获取数据库连接');
  const db = await getDb();
  console.log('已获取数据库连接');
  console.log('开始获取集合');
  const collection = db.collection('myCollectionName');
  console.log('已获取集合');
  

• 查看Docker容器的完整日志，包括stderr输出：

  docker logs -f your-container-id
  

5. 验证依赖版本一致性 #

• 确保Docker构建时使用的依赖版本与本地一致，将package-lock.json或yarn.lock包含在Docker镜像构建目录中，避免依赖版本差异导致的兼容性问题。

6. 最小化连接测试 #

创建一个独立的测试脚本，排除应用其他代码干扰，直接测试连接和查询：

import { MongoClient } from 'mongodb';

async function testAzureMongo() {
  const url = process.env.MONGO_URL;
  const dbName = process.env.MONGO_NAME;
  try {
    const client = new MongoClient(url, { connectTimeoutMS: 10000, retryWrites: false });
    await client.connect();
    console.log('连接成功');
    const db = client.db(dbName);
    // 测试获取集合列表
    const collections = await db.listCollections().toArray();
    console.log('数据库集合:', collections);
    await client.close();
  } catch (err) {
    console.error('测试失败:', err);
  }
}

testAzureMongo();

将该脚本放入Docker容器运行，观察输出结果，定位问题是否出在连接环节。

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