在使用Node.js开发需要对接MongoDB数据库的应用时，不少开发者会遇到连接本地MongoDB后程序直接卡死的情况，既没有错误提示，也不会执行后续的代码逻辑，只能手动终止进程。这种问题通常和连接配置、驱动使用方式、异常处理逻辑相关，需要从多个维度排查解决。
常见卡死原因及对应解决方案
1. 未设置连接超时与合理的回调处理
很多新手使用MongoDB官方Node.js驱动时，没有配置连接超时参数，也没有正确处理连接成功或失败的回调，导致连接过程一直阻塞，程序就出现了卡死的现象。可以在连接时添加serverSelectionTimeoutMS参数设置服务器选择超时时间，同时完善回调逻辑。
以下是正确配置连接参数的示例代码：
const { MongoClient } = require('mongodb');
// 本地MongoDB默认连接地址
const url = 'mongodb://127.0.0.1:27017';
// 设置连接超时时间为5秒，避免无限等待
const options = {
serverSelectionTimeoutMS: 5000,
connectTimeoutMS: 5000
};
async function connectDB() {
let client;
try {
client = new MongoClient(url, options);
// 发起连接请求
await client.connect();
console.log('本地MongoDB连接成功');
// 连接成功后可以执行后续数据库操作
const db = client.db('test_db');
const collection = db.collection('test_collection');
const result = await collection.find({}).toArray();
console.log('查询结果：', result);
} catch (err) {
// 捕获连接或操作过程中的错误
console.error('数据库连接或操作失败：', err.message);
} finally {
// 无论成功失败都关闭连接，避免资源占用
if (client) {
await client.close();
console.log('数据库连接已关闭');
}
}
}
connectDB();2. 驱动版本不兼容
如果你的Node.js版本较新，但使用的MongoDB驱动版本过旧，也可能出现连接卡死的问题。建议查看当前驱动版本，升级到和Node.js版本匹配的官方驱动。可以通过npm命令查看和升级驱动：
- 查看当前驱动版本：
npm list mongodb - 升级到最新稳定版：
npm install mongodb@latest
3. 本地MongoDB服务未正常运行
有时候程序卡死不是Node.js代码的问题，而是本地MongoDB服务没有正常启动。可以先检查MongoDB服务状态，在命令行执行mongosh命令，如果能正常进入MongoDB交互终端，说明服务运行正常；如果提示连接失败，需要先启动本地MongoDB服务。
4. 连接地址格式错误
错误的连接地址也会导致连接一直阻塞，比如把端口写错、或者使用了不正确的协议格式。本地MongoDB默认端口是27017，连接地址格式应为mongodb://127.0.0.1:27017，不要遗漏端口号或者写错IP地址。
调试技巧
如果以上方法都没有解决问题，可以在连接时添加日志输出，或者在驱动配置中开启调试模式，查看连接过程的具体状态：
const { MongoClient } = require('mongodb');
const url = 'mongodb://127.0.0.1:27017';
const options = {
serverSelectionTimeoutMS: 5000,
// 开启驱动内部日志，方便排查问题
loggerLevel: 'debug'
};
async function connectDB() {
const client = new MongoClient(url, options);
console.log('开始尝试连接MongoDB...');
try {
await client.connect();
console.log('连接成功');
} catch (err) {
console.error('连接失败：', err);
}
}
connectDB();通过以上方法基本可以解决大部分Node.js连接本地MongoDB卡死的问题，开发时建议始终做好超时配置和异常处理，避免程序出现无响应的阻塞情况。