使用concurrently同时启动前后端服务时npm run dev报错，单独运行前后端命令正常

已知运行条件 #

• 项目结构为根目录下包含独立的frontend、backend子文件夹
• 根目录package.json的scripts配置如下：

"scripts": {
  "test": "echo \"Error: no test specified\" && exit 1",
  "server": "nodemon backend/server.js",
  "client": "npm start --prefix frontend",
  "dev": "concurrently \"npm run server\" \"npm run client\""
}

• 单独执行npm run server、npm run client均可正常启动，仅执行npm run dev时抛出如下通用报错：

npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! ecommerce_shop@1.0.0 dev: `concurrently "npm run server" "npm run client"`
npm ERR! Exit status 1
npm ERR! 
npm ERR! Failed at the ecommerce_shop@1.0.0 dev script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR!     /home/user/.npm/_logs/2021-01-29T18_24_43_756Z-debug.log

高频根因与对应修复方案 #

1. 未安装concurrently依赖（同类场景最高发原因） #

报错最外层的npm通用提示不会直接打印“command not found”类的细节错误，这类错误会被折叠在报错块上方的日志输出里。如果项目没有安装concurrently依赖，系统在执行dev脚本时找不到对应可执行程序，就会直接返回退出码1触发ELIFECYCLE报错。
修复操作：在项目根目录执行安装命令：
npm install concurrently --save-dev
安装完成后重新执行npm run dev验证。

2. 脚本引号转义兼容问题 #

当前脚本使用嵌套双引号包裹子命令的写法，在Windows cmd、PowerShell、Linux shell、Mac zsh等不同终端环境下会出现解析差异，导致concurrently无法正确拆分出需要执行的两个子命令，运行直接失败。
修复操作：将dev脚本的嵌套双引号替换为单引号写法，实现跨终端兼容：

"dev": "concurrently 'npm run server' 'npm run client'"

3. 子进程错误被外层报错遮挡 #

如果完成上述两步修复后仍然报错，大概率是子进程的真实错误被npm的通用报错块顶到了日志上方，肉眼浏览时容易错过。可以通过以下两种方式拿到真实错误原因：

• 绕过npm scripts的包裹，直接在根目录执行命令：npx concurrently "npm run server" "npm run client"，即可完整看到两个子进程的实时输出，定位具体是哪个进程抛出了错误
• 直接打开报错提示中给出的完整日志文件/home/user/.npm/_logs/2021-01-29T18_24_43_756Z-debug.log，日志头部会记录触发退出的具体错误原因，比如端口被占用、依赖版本不兼容等。

4. 可选调试优化 #

如果需要长期排查这类集成运行的问题，可以调整dev脚本为带进程标签的输出模式，把不同进程的日志用颜色和名称标记区分开，避免日志混杂看不清：

"dev": "concurrently -n \"后端服务,前端应用\" -c \"blue,green\" \"npm run server\" \"npm run client\""

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