Node.js连接CosmosDB(MongoAPI)时出现Cannot read property 'collection' of null错误

这个错误核心是你在MongoClient.connect的回调里拿到的db对象为null，大概率是连接逻辑或配置出了问题，咱们一步步排查解决：

1. 适配MongoDB驱动版本的API变化 #

从MongoDB Node.js驱动v3.0开始，MongoClient.connect的回调返回的第二个参数是**client实例**，而非直接的数据库对象。你的代码里直接把这个参数当作db使用，自然会导致后续调用db.collection时报错。

修改你的连接代码段：

MongoClient.connect(url, function(err, client) {
  if (err) {
    console.error('连接失败:', err);
    return;
  }
  // 替换成你实际要操作的数据库名称
  const db = client.db('your-target-db');
  
  insertDocument(db, function() {
    findFamilies(db, function() {
      updateFamilies(db, function() {
        removeFamilies(db, function() {
          client.close(); // 新版本驱动要关闭client而非db
        });
      });
    });
  });
});

2. 修复连接字符串的格式问题 #

你的连接字符串里有明显的占位符处理错误：

var url = 'mongodb://<endpoint>:<`enter code `enter code here`here`password>@<endpoint>.documents.azure.com:10255/?ssl=true';

正确的格式应该是：

• 把<endpoint>替换成你的Azure Cosmos DB账户名
• 把<password>替换成你的账户密码（注意：密码含特殊字符时要URL编码，比如@换成%40，+换成%2B）
• 删除多余的enter code here无效字符
• 建议添加retrywrites=false参数（Azure Cosmos DB暂不支持重试写入）

示例正确连接字符串：

var url = 'mongodb://my-cosmos-account:my-url-encoded-password@my-cosmos-account.documents.azure.com:10255/?ssl=true&retrywrites=false';

3. 排查网络与权限配置 #

虽然Robomongo能连接，但仍要确认：

• 你的Node.js运行环境IP是否在Azure Cosmos DB的防火墙允许列表中（如果开启了IP白名单）
• 密码是否完全匹配，复制时有没有大小写错误或字符遗漏

4. 优化错误排查逻辑 #

暂时注释掉assert.equal(null, err)，换成错误日志打印，避免异常掩盖真实问题：

MongoClient.connect(url, function(err, client) {
  if (err) {
    console.error('连接失败详情:', err);
    return;
  }
  // 后续操作...
});

按以上步骤调整后，应该能解决连接问题。

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