SuperTest 库中解决循环测试时偶发"socket hang up"错误的技术分析

在基于 Node.js 的 API 测试中，SuperTest 是一个广泛使用的 HTTP 断言库。开发者在使用 SuperTest 进行高频次循环测试时，可能会遇到偶发性的"socket hang up"等底层网络错误。这类问题通常出现在对速率限制功能进行测试的场景中。

问题现象

当开发者尝试以下测试代码时：

const app = express();
app.get("/", (req, res) => res.send("OK"));
const superAgent = request(app);

for (let i = 0; i < 1000; i++) {
  await superAgent.get("/").expect(200);
}

测试过程中会随机出现"socket hang up"错误，导致测试用例失败。这种问题在连续高频请求时尤为明显。

根本原因分析

经过技术分析，发现问题根源在于 SuperTest 的内部实现机制。当直接传入 Express 应用实例时，SuperTest 会在每次请求时动态创建和销毁 HTTP 服务器。这种设计在高频请求场景下会导致：

1. 端口资源频繁分配和释放
2. TCP 连接未能正确关闭
3. 操作系统资源限制被触发

解决方案

可靠的解决方案是预先创建一个监听状态的 HTTP 服务器实例，然后将其传递给 SuperTest：

const app = express();
app.get("/", (req, res) => res.send("OK"));
const server = http.createServer(app).listen(0); // 使用随机端口
const superAgent = request(server);

for (let i = 0; i < 1000; i++) {
  await superAgent.get("/").expect(200);
}

这种方式的优势在于：

• 保持单一的 HTTP 服务器实例
• 避免端口资源频繁分配
• 维持稳定的 TCP 连接池

技术实现原理

SuperTest 在 v7.1.0 版本中优化了这一问题。其内部实现现在会：

1. 自动管理服务器生命周期
2. 重用 TCP 连接
3. 正确处理连接终止
4. 优化端口资源分配策略

最佳实践建议

对于需要高频测试的场景，建议开发者：

1. 显式创建并管理 HTTP 服务器实例
2. 在测试套件开始时启动服务器
3. 测试结束后正确关闭服务器
4. 考虑使用连接池配置
5. 适当增加测试间隔时间

这种模式不仅解决了偶发性错误问题，还能提高测试执行效率和稳定性，特别适合对 API 进行压力测试和边界条件验证的场景。