Mocha测试中间件：如何让所有it回调并行执行？

方案1：开启Mocha的并行测试模式 #

Mocha从8版本开始支持并行执行测试，直接通过命令行参数开启：

mocha --parallel

也可以在.mocharc.json配置文件中添加设置：

{
  "parallel": true
}

注意：该模式仅让不同测试文件并行执行，同一个describe块内的it仍会按顺序串行运行。如果你的测试用例都在同一个describe里，要么拆分到不同文件，要么结合下方方案处理。

方案2：每个测试用例独立初始化服务实例 #

问题核心是多个it共用了同一个服务实例，第一个it启动服务后，第二个it还没来得及注册中间件就启动了服务，导致测试失败。最稳妥的解决方式是让每个it单独创建、启动、销毁服务：

const assert = require('assert');
const MyMiddlewareServer = require('./你的服务模块');

describe('中间件测试', function() {
  let server;

  // 每个it执行前，创建全新的服务实例
  beforeEach(function() {
    server = new MyMiddlewareServer();
  });

  // 每个it执行完成后，销毁当前服务
  afterEach(function(done) {
    server.stop(done); // 假设你的stop方法为异步，接受done回调
  });

  it('测试第一个中间件', function(done) {
    server.use((req, res, next) => {
      res.send('first');
      next();
    });
    server.start(() => {
      // 编写发送请求、断言结果的测试逻辑
      // ...
      done();
    });
  });

  it('测试第二个中间件', function(done) {
    server.use((req, res, next) => {
      res.send('second');
      next();
    });
    server.start(() => {
      // 编写对应测试逻辑
      // ...
      done();
    });
  });
});

每个测试用例都拥有独立的服务环境，前一个测试的服务销毁后不会影响后续测试，自然能在start前顺利完成中间件注册。

方案3：手动控制服务启停顺序 #

如果必须共用服务实例，需确保前一个测试彻底停止服务后，再重新配置下一个测试的中间件：

const assert = require('assert');
const MyMiddlewareServer = require('./你的服务模块');

describe('中间件测试', function() {
  let server = new MyMiddlewareServer();

  // 所有测试完成后统一销毁服务
  after(function(done) {
    server.stop(done);
  });

  it('测试第一个中间件', function(done) {
    server.use((req, res, next) => {
      res.send('first');
      next();
    });
    server.start(() => {
      // 编写测试逻辑
      // ...
      // 测试完成后立即停止服务，为下一个测试腾清环境
      server.stop(() => done());
    });
  });

  it('测试第二个中间件', function(done) {
    // 重新创建服务实例，避免残留之前的中间件配置
    server = new MyMiddlewareServer();
    server.use((req, res, next) => {
      res.send('second');
      next();
    });
    server.start(() => {
      // 编写对应测试逻辑
      // ...
      server.stop(() => done());
    });
  });
});

关键注意点 #

• Mocha默认串行执行it，前一个it中的异步操作未完成时，会阻塞后续it的回调执行。必须通过done回调或返回Promise的方式，明确告知Mocha当前测试已完成。
• 尽量避免测试用例之间的依赖，每个测试用例使用独立的资源是最可靠的方式，能减少大部分异常问题。

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