执行nx serve app命令报错：无法找到app的externalDependency 'webpack-cli'

问题定位 #

执行nx serve app时出现守护进程断开错误，查看/{pathtoproject}/.nx/cache/d/daemon.log日志，明确是**webpack-cli依赖未找到**导致的问题。

解决方案步骤 #

• 检查并安装webpack-cli依赖
  查看项目根目录的package.json，确认devDependencies中是否存在webpack-cli。如果没有，执行对应包管理器命令安装：

  # npm 用户
  npm install --save-dev webpack-cli
  
  # Yarn 用户
  yarn add --dev webpack-cli
  
  # pnpm 用户
  pnpm add -D webpack-cli
  

• 清理Nx缓存与守护进程
  旧缓存或异常守护进程可能导致依赖识别异常，执行以下操作：

  # 停止Nx守护进程
  nx daemon stop
  
  # 删除Nx缓存目录（Linux/macOS）
  rm -rf .nx/cache
  
  # Windows系统执行此命令
  rmdir /s /q .nx\cache
  

• 重新启动服务
  完成上述操作后，再次运行：

  nx serve app
  

• 排查配置异常（如果上述步骤无效）
  检查项目的project.json中targets.serve配置，确认是否手动指定了错误的webpack-cli路径；同时查看根目录nx.json的tasksRunnerOptions，确保没有配置冲突。

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