ASP.NET Core 3.1搭配React的项目运行时报未处理异常，如何解决？

• 最核心原因是Node.js版本不兼容：ASP.NET Core 3.1官方提供的React项目模板仅适配Node.js 12.x/14.x LTS版本，本地安装的Node.js版本高于14.x时，就会出现构建报错。你之前做的jQuery类项目不需要Node.js构建环境，所以不会触发这个问题，而React项目依赖Node.js完成构建流程，所以只要环境不匹配就会报错。
• 次要原因是Visual Studio的Node.js调用优先级异常：如果Visual Studio内置的Node工具优先级高于系统安装的Node.js，即便你命令行装了正确版本，VS运行项目时还是会调用错版本。
• 另外如果本地存在多版本Node.js、环境变量配置冲突，也会导致这个问题。

1. 安装匹配的Node.js版本
   卸载本地现有Node.js，安装Node.js 14.x LTS版本，安装完成后打开命令行执行 node -v，确认返回v14开头的版本号即为成功。
2. 调整Visual Studio的Node调用优先级
   打开Visual Studio，依次进入「工具 > 选项 > 项目和解决方案 > Web包管理 > 外部Web工具」，在列表中找到 $(PATH) 项，点击向上箭头把它移动到列表的最顶部，点击确定保存设置。
3. 清理项目缓存并重建依赖

• 关闭Visual Studio，删除项目根目录下的 bin、obj 文件夹，再删除React前端目录（默认是ClientApp文件夹）下的 node_modules 文件夹和 package-lock.json 文件。
• 重新打开项目，右键点击ClientApp文件夹选择「在命令行中打开」，执行 npm install 安装依赖。

4. 验证启动
   依赖安装完成后，先在ClientApp的命令行中执行 npm start，确认React前端可以正常启动无报错后，再回到Visual Studio点击运行按钮启动整个项目即可。

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