Node.js服务代码修改后端口占用问题求助（9229/3001端口）

一、9229端口（调试检查器）重复监听问题 #

9229是Node.js默认的调试检查器端口，同一进程同时监听IPv4和IPv6是Node.js的默认行为，但重启时报错说明旧进程的调试端口未被正确释放。解决方法：

• 修复热重启进程管理：如果用nodemon等工具做热重启，添加参数强制终止旧进程：

  nodemon --kill-signal=SIGTERM your-server.js
  

  或使用--force-exit确保旧进程完全退出。

• 显式绑定调试端口：启动时指定调试端口并绑定到单一IP，避免双栈监听冲突：

  node --inspect=127.0.0.1:9229 your-server.js
  

• 完善进程退出逻辑：在服务代码中添加信号监听，确保收到终止信号时关闭服务并退出进程：

  const server = http.createServer(...);
  
  process.on('SIGINT', () => {
    server.close(() => {
      process.exit(0);
    });
  });
  
  process.on('SIGTERM', () => {
    server.close(() => {
      process.exit(0);
    });
  });
  

二、3001端口EADDRINUSE问题 #

报错提示3001端口被占用，核心原因是旧进程未完全释放端口，或代码存在重复监听逻辑。排查方案：

• 定位并清理占用进程：

  • Linux/macOS：执行lsof -i :3001找到进程ID，再用kill -9 <PID>强制杀死。
  • Windows：执行netstat -ano | findstr :3001获取PID，通过任务管理器结束对应进程。

• 检查代码重复监听：确认代码中是否多次调用server.listen(3001)，比如模块重复加载导致创建多个Server实例。可在listen前加日志验证调用次数：

  console.log('Trying to listen on port 3001');
  server.listen(3001, () => {
    console.log('Server started on http://localhost:3001');
  });
  

• 指定单一IP监听：避免双栈监听导致的端口残留，显式绑定到IPv4地址：

  server.listen(3001, '127.0.0.1', () => {
    console.log('Server started on http://localhost:3001');
  });
  

• 临时启用端口复用：在listen时添加reuseAddr参数允许端口复用（仅作为临时 workaround，需优先解决进程退出问题）：

  server.listen(3001, { reuseAddr: true }, () => {
    console.log('Server started on http://localhost:3001');
  });
  

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