Mocha集成测试后因Mongoose连接挂起问题排查

Talk is cheap, show me the code — Linus Torvald

嘿，我来帮你捋捋这个问题！你遇到的情况其实挺常见的，核心问题就是Mongoose的数据库连接没在测试结束后主动关闭，导致Mocha被活跃的连接“拖住”，没法正常退出进程。咱们拆解下原因和解决办法：

为啥会出现这种情况？ #

首先，mongoose.connect()是异步操作，你的测试用例执行速度比连接建立快，所以“Connected to mongodb”日志会在测试跑完才出来，这是异步时序的问题。而Mocha挂起的根本原因是：Mongoose建立连接后会维持一个持久的连接池，默认不会自动关闭——哪怕你的测试没用到数据库，只要这个连接还开着，Mocha就会认为还有活跃任务，不会主动退出，只能手动Ctrl+C终止。

具体怎么解决？ #

1. 用Mocha钩子主动关闭连接 #

这是最规范的做法，在所有测试执行完后，调用mongoose.disconnect()关闭连接。你可以在测试文件里加个after()钩子：

const mongoose = require('mongoose');

// 你的测试代码（比如supertest的请求测试）...

// 所有测试完成后关闭数据库连接
after(async () => {
  await mongoose.disconnect();
});

这个钩子会在所有测试用例跑完后触发，异步关闭连接，释放资源，Mocha就能正常退出了。

2. 测试环境跳过连接初始化（可选） #

如果你的测试完全不需要数据库，那干脆别在测试环境里建立连接就行。可以通过环境变量判断：

// 只在非测试环境建立连接
if (process.env.NODE_ENV !== 'test') {
  mongoose.connect('mongodb://localhost:27017/your-db-name')
    .then(() => console.log('Connected to mongodb'))
    .catch(err => console.error('MongoDB connection error:', err));
}

这样测试时就不会初始化连接，自然不会有挂起的问题。

3. 应急用Mocha的--exit参数（不推荐长期用） #

Mocha从v4开始默认不会强制退出进程，你可以在启动命令里加--exit参数，让它测试完就强制退出：

mocha --exit

不过这个方法只是“硬掰”进程退出，没有真正释放数据库连接资源，所以还是优先用前两种方法。

额外小提示 #

如果以后你的测试需要用到数据库，建议用before()钩子在测试前建立连接，after()钩子在测试后关闭，保证每个测试套件的环境是干净的：

before(async () => {
  // 测试前建立连接
  await mongoose.connect('mongodb://localhost:27017/test-db');
});

after(async () => {
  // 测试后关闭连接
  await mongoose.disconnect();
});

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