升级MongoDB社区版与Ubuntu服务器后Node.js连接无响应问题

1. 验证驱动版本兼容性 #

新升级的MongoDB社区版（如6.0/7.0版本）对Node.js驱动版本有明确要求：

• MongoDB 6.0+ 需搭配 mongodb 原生驱动v4.1.0+，或mongoose ORM v6.0+
• 执行以下命令查看当前驱动版本：

  npm list mongodb
  # 或使用mongoose时执行
  npm list mongoose
  

  若版本不兼容，直接升级到对应兼容版本：

  npm install mongodb@latest
  # 或mongoose
  npm install mongoose@latest
  

2. 检查连接字符串与认证配置 #

• 如果MongoDB开启了权限认证（mongod.conf中security.authorization: enabled），Node.js连接字符串必须包含正确的用户名、密码和认证源：

  // 原生驱动示例
  const { MongoClient } = require('mongodb');
  const uri = 'mongodb://username:password@localhost:27017/your_database?authSource=admin';
  

  注意：mongosh默认对localhost连接有免认证例外，但Node.js驱动严格遵循认证规则，即使本地连接也需传入正确凭证。

3. 排查网络与端口访问 #

• 测试Node.js运行环境是否能访问MongoDB端口：

  nc -zv localhost 27017
  

  如果不通，检查两项配置：
  • mongod.conf中net.bindIp是否设置为127.0.0.1或0.0.0.0（不要仅绑定外部IP）
  • Ubuntu防火墙ufw是否限制本地端口：执行ufw status查看，必要时临时放行测试：ufw allow 27017

4. 增强Node.js代码的错误日志 #

默认错误捕获可能无法暴露问题，添加超时设置与事件监听，避免代码无限挂起：

const { MongoClient } = require('mongodb');
const uri = 'mongodb://localhost:27017/your_database';

const client = new MongoClient(uri, {
  serverSelectionTimeoutMS: 5000  // 设置5秒超时，快速获取错误
});

async function connect() {
  try {
    await client.connect();
    console.log('连接成功');
    // 执行测试查询验证连通性
    const db = client.db('your_database');
    const testResult = await db.collection('test').findOne();
    console.log('测试查询结果:', testResult);
  } catch (err) {
    console.error('连接/查询失败:', err);
    console.error('错误详情:', err.stack);
  } finally {
    await client.close();
  }
}

// 监听连接池事件，定位连接流程问题
client.on('connectionPoolCreated', () => console.log('连接池已创建'));
client.on('connectionCreated', () => console.log('新连接已建立'));
client.on('connectionClosed', () => console.log('连接已关闭'));

connect();

5. 检查MongoDB日志中的连接记录 #

实时查看MongoDB日志，捕捉Node.js连接的关键信息：

tail -f /var/log/mongodb/mongod.log

运行Node.js代码后，观察日志中是否出现connection accepted（连接成功）、authentication failed（认证失败）或connection refused（连接被拒绝）等条目，直接定位问题根源。

6. 验证用户权限 #

若使用认证账号，确保该账号拥有目标数据库的读写权限：
在mongosh中执行：

use admin
db.auth('username', 'password')
use your_database
db.grantRolesToUser('username', [{ role: 'readWrite', db: 'your_database' }])

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