ASP.NET Core+React项目运行报npm脚本'start'退出错误如何解决

• 检查前端依赖安装完整性
  进入项目默认的前端根目录ClientApp，手动执行npm install，确认安装过程无报错。VS 2019脚手架生成项目时可能因网络波动出现依赖拉取不全的问题，这是最常见的触发原因。
• 单独验证前端启动逻辑
  在ClientApp目录下直接执行npm start，观察终端输出：
  • 若正常启动并打开React开发页面，说明前端本身无问题，故障出在.NET后端和前端服务的联动配置上
  • 若直接报错退出，优先检查react-scripts版本兼容性：.NET 5内置的React模板适配react-scripts 4.x版本，执行npm install react-scripts@4.0.3 --save替换版本后重试即可，Node.js v14和该版本完全兼容，无需调整Node版本。
• 调整.NET SPA启动配置
  打开项目根目录的Startup.cs文件，首先确认ConfigureServices方法中静态文件配置正确：

  services.AddSpaStaticFiles(configuration =>
  {
      configuration.RootPath = "ClientApp/build";
  });
  

  再找到Configure方法中的React开发服务启动配置，延长启动超时时间避免因前端启动慢被判定为退出：

  // 原默认配置
  // spa.UseReactDevelopmentServer(npmScript: "start");
  // 修改为以下配置，延长超时到120秒
  spa.UseReactDevelopmentServer(npmScript: "start", timeout: TimeSpan.FromSeconds(120));
  

• 排查端口占用
  执行命令netstat -ano | findstr "3000"检查React默认3000端口是否被占用，若被占用可在ClientApp目录下新建.env文件，添加配置PORT=3001（替换为任意未被占用的端口）指定前端服务端口。

快速修复方案 #

如果上述排查后仍无法启动，可直接执行以下操作：

1. 删除ClientApp目录下的node_modules文件夹、package-lock.json文件
2. 执行npm install -g npm@6.14.18将npm版本切换到Node.js v14适配的LTS版本，避免高版本npm的依赖锁冲突
3. 回到ClientApp目录重新执行npm install，再启动.NET项目即可。

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