使用Jest测试Express接口：单独运行正常批量运行随机失败

核心问题分析 #

批量测试时出现的EADDRINUSE和ECONNRESET，本质是固定端口导致的资源竞争和服务关闭不彻底/请求未正确处理错误：

• 固定端口4500，Jest并行运行测试文件时，多个进程会同时尝试绑定该端口，引发端口占用错误。
• 服务关闭不及时或未等待关闭完成，后续测试请求会连接到已被终止的服务，触发ECONNRESET，进而导致读取status时因响应未定义报错。

具体解决方案 #

1. 动态分配端口，避免固定端口竞争 #

不要硬编码端口4500，让系统自动分配空闲端口：

// jest.setup.js 或测试文件内的服务启动代码
const app = require('../app'); // 你的Express应用实例
let server;

beforeAll(async () => {
  // 端口设为0，系统会自动分配可用端口
  server = app.listen(0);
  // 将分配的端口存入全局变量，供测试用的Axios请求使用
  global.testPort = server.address().port;
});

测试中发起Axios请求时，使用全局变量的端口：

// helpers/tests.js 中的checkInvalidDatetime方法
const axios = require('axios');

async function checkInvalidDatetime() {
  const baseUrl = `http://localhost:${global.testPort}`;
  try {
    const response = await axios.get(`${baseUrl}/your-api-endpoint`);
    // 后续逻辑
  } catch (err) {
    // 处理错误
  }
}

2. 确保服务彻底关闭，等待关闭完成 #

server.close()是异步操作，必须等待其完成再结束测试，否则会残留连接：

afterAll(async () => {
  await new Promise((resolve) => {
    server.close(resolve); // 传入回调，确保关闭完成后再resolve
  });
});

3. 为每个测试文件独立启动/关闭服务（可选） #

如果全局setup仍有冲突问题，放弃jest.setup.js的全局启动，改为在每个测试文件内单独管理服务生命周期：

// positions.test.js
const app = require('../app');
let server;

beforeAll(async () => {
  server = app.listen(0);
  global.testPort = server.address().port;
});

afterAll(async () => {
  await new Promise(resolve => server.close(resolve));
});

// 测试用例
test('your test case', async () => {
  // ...
});

4. 增强Axios请求的错误处理，避免崩溃 #

在checkInvalidDatetime中捕获连接类错误，避免因err.response未定义导致的status读取报错：

async function checkInvalidDatetime() {
  const baseUrl = `http://localhost:${global.testPort}`;
  try {
    const response = await axios.get(`${baseUrl}/your-api-endpoint`);
    return response.status;
  } catch (err) {
    // 区分响应错误和连接错误
    if (err.response) {
      return err.response.status;
    } else {
      // 处理ECONNRESET等连接错误，比如抛出明确错误或返回特定标识
      throw new Error(`请求失败：${err.message}`);
    }
  }
}

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