npm concurrently运行时Ctrl+C无法终止端口进程怎么办

问题根因 #

该问题仅出现在Windows环境：npm执行脚本时会自动生成嵌套的cmd.exe批处理子进程，concurrently默认无法将Ctrl+C发出的SIGINT终止信号透传到所有嵌套子进程，就会反复弹出Terminate batch job (Y/N)?提示，输入Y或重复按Ctrl+C都无法被正确捕获，最终导致端口被残留进程占用。

可落地解决方案 #

方案1：调整concurrently启动参数（无需额外依赖，优先使用） #

修改package.json中的dev脚本配置，补充信号透传、强制杀进程参数，同时关闭npm本身的批处理交互提示：

"dev": "concurrently --kill-others --kill-signal=SIGINT --raw \"npm run start -- --silent\" \"npm run server -- --silent\""

参数作用：

• --kill-others：任意一个进程退出时立刻强制终止所有关联进程，覆盖手动终止场景，比原配置的--kill-others-on-fail适用范围更广
• --kill-signal=SIGINT：明确指定终止信号为Ctrl+C对应的SIGINT，解决Windows下信号识别异常问题
• --raw：直接输出子进程原始日志，不做concurrently层面的封装拦截，减少信号传递断层
• 每个npm run命令后追加-- --silent：关闭npm自身的批处理交互逻辑，从根源避免弹出终止询问
  配置修改后重新执行npm run dev，按Ctrl+C即可直接终止所有进程，端口会正常释放，不会再卡提示。

方案2：直接调用执行命令，跳过npm嵌套 #

如果方案1仍有残留进程，不要在concurrently中嵌套调用npm run，直接写各脚本对应的实际执行命令，彻底避免cmd批处理嵌套。
举个例子，如果你的start脚本实际执行的是react-scripts start，server脚本实际执行的是nodemon server.js，就把dev脚本改为：

"dev": "concurrently --kill-others --kill-signal=SIGINT \"react-scripts start\" \"nodemon server.js\""

少了npm run生成的中间cmd进程层，信号传递不会被拦截，可保证正常终止。

方案3：临时快速释放已被占用的端口 #

如果已经出现进程卡住、端口被占用的情况，不需要手动去任务管理器翻找进程，直接在终端执行命令即可快速释放：

• 查询占用目标端口的进程PID（以3000端口为例）：
  netstat -ano | findstr :3000
• 拿到返回结果最后一列的数字PID后，执行强制杀进程命令：
  taskkill /F /PID 替换为你查到的PID

注意：concurrently启动的多个进程为父子关联关系，杀掉其中一个服务的主进程，其余关联进程会同步退出，不需要逐个端口查杀。

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