测试API端点时测试失败的原因：端口3000占用错误排查

错误原因 #

报错listen EADDRINUSE: address already in use :::3000说明3000端口已被其他进程占用，导致测试用例启动服务时无法绑定该端口。

解决方案 #

1. 杀掉占用3000端口的进程 #

• Windows系统：
  打开命令提示符执行：

  netstat -ano | findstr :3000
  

  找到输出中的PID数字后，执行：

  taskkill /F /PID 替换为找到的PID值
  

• macOS/Linux系统：
  打开终端执行：

  lsof -ti:3000 | xargs kill -9
  

2. 重构服务启动逻辑，避免测试重复启动 #

检查你的入口文件（比如app.js），如果直接在文件内写了app.listen(3000)，那每次导入该文件（如测试代码里的import app from ".."）都会尝试启动服务，极易引发端口冲突。

建议拆分服务启动代码：

// app.js - 仅导出Express实例，不启动服务
import express from 'express';
const app = express();

// 配置中间件、路由等逻辑
app.get('/api/images', (req, res) => { /* 业务逻辑 */ });

export default app;

// server.js - 单独负责启动服务
import app from './app';
app.listen(3000, () => {
  console.log('Server running on port 3000');
});

这样测试代码导入app时不会自动启动服务，SuperTest会自行处理服务的启停，避免端口占用。

3. 测试环境使用随机端口 #

在服务启动时判断环境，测试环境下设端口为0（系统会自动分配可用随机端口）：

const port = process.env.NODE_ENV === 'test' ? 0 : 3000;
app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

这种方式无需担心端口被占用，测试可正常运行。

内容的提问来源于stack exchange，提问作者ziad-amer-1