uWebSockets.js 测试中 ECONNRESET 错误的解决方案

在使用 uWebSockets.js 进行单元测试时，开发者可能会遇到一个常见问题：当运行多个测试用例时，只有第一个测试能够通过，后续测试会出现 ECONNRESET 错误。这个问题看似简单，但实际上涉及到了 Node.js 网络编程和测试执行流程中的几个关键概念。

问题现象分析

在测试场景中，我们通常会创建多个测试用例来验证 uWebSockets.js 服务器的不同行为。当这些测试连续执行时，第一个测试能够正常完成，但后续测试会抛出 ECONNRESET（连接被重置）错误。这种现象表明在测试环境清理或初始化过程中存在资源管理问题。

根本原因

这个问题的核心原因在于以下几个方面：

1. 端口重用问题：虽然测试用例中使用了 afterEach 来关闭服务器，但 TCP 端口在关闭后可能仍处于 TIME_WAIT 状态，导致后续测试无法立即重用同一端口。

2. 请求时机不当：原始代码中在服务器启动后立即发起请求，没有确保服务器已经完全准备好接收连接。

3. HTTP 客户端错误处理缺失：使用 Node.js 原生 http 模块时，没有正确处理连接错误情况。

解决方案

1. 使用 fetch API 替代 http 模块

现代 JavaScript 的 fetch API 提供了更简洁的错误处理机制，能够更好地处理连接问题：

const req = (path, options = {}) => {
  return fetch(`http://localhost:${port}${path}`)
    .then(res => ({ statusCode: res.status }));
}

2. 确保服务器完全启动后再测试

将测试逻辑放在服务器的 listen 回调中，确保服务器完全启动后再执行测试：

it('测试用例', (_, done) => {
  app.get('/', (res) => { res.end('响应内容') })
    .listen(port, async s => {
      if (!s) throw '监听失败';
      const res = await req('/');
      strictEqual(res.statusCode, 200);
      done();
    });
});

3. 考虑使用动态端口分配

对于测试环境，更健壮的做法是让系统自动分配可用端口：

import { createServer } from 'node:net';

async function getAvailablePort() {
  return new Promise((resolve) => {
    const server = createServer();
    server.listen(0, () => {
      const port = server.address().port;
      server.close(() => resolve(port));
    });
  });
}

最佳实践建议

1. 隔离测试环境：每个测试用例应该使用独立的服务器实例和端口，避免相互干扰。

2. 完善的错误处理：对所有网络操作添加适当的错误处理逻辑。

3. 资源清理：确保在测试结束后正确释放所有网络资源。

4. 考虑使用测试框架：成熟的测试框架如 Jest 或 Mocha 提供了更好的异步测试支持和资源管理功能。

通过以上方法，可以有效地解决 uWebSockets.js 测试中的 ECONNRESET 问题，构建更稳定可靠的测试套件。