TeamCity构建React应用报Cannot find module错误如何解决

• 报错本质是TeamCity构建代理使用的Node.js环境损坏：当前被调用的是e:\nodejs\12.0.0路径下的12.0.0版本Node，该安装目录缺失npm核心运行文件npm-cli.js，导致npm命令完全无法执行。
• 版本不匹配：你项目package.json里明确声明Node版本要求为>=12.18.2，12.0.0本身就不符合项目的版本要求，就算文件完整也可能存在依赖兼容问题。
• 本地构建正常是因为本地Node环境安装完整、版本符合要求，和TeamCity代理端的损坏环境没有关联。这类突然出现的构建失败，大多是构建代理近期做过环境清理、软件卸载、路径配置修改，导致旧版Node文件被误删、环境变量指向错误路径。

• 第一步：清理损坏的Node环境
  登录出问题的Windows构建代理，直接删除报错路径下的e:\nodejs\12.0.0\node-v12.0.0-win-x64损坏文件夹，避免后续配置错误时再次被调用。
• 第二步：配置符合要求的Node运行环境
  • 如果使用TeamCity官方Node.js插件管理版本：打开React构建对应的Job配置，在构建环境设置里选中Node.js插件，指定版本为12.18.2以上的LTS版本（推荐16.x或18.x，对React脚手架的兼容性最好），勾选「构建时自动下载对应版本Node」选项，不要依赖代理机器上预装的全局Node，避免环境不一致问题。
  • 如果是通过Build.ps1脚本手动指定Node路径：修改脚本里的Node路径配置，指向提前在代理上完整安装、版本>=12.18.2的Node目录，确认对应路径下node_modules\npm\bin\npm-cli.js文件存在后再保存配置。
• 第三步：验证环境有效性
  在构建步骤的最前面增加一行校验命令：

  node -v
  npm -v
  

  重新触发构建，先确认日志输出的Node版本符合要求、npm命令可以正常返回版本号，再执行后续的依赖安装、项目打包操作。

注意：该问题属于构建环境配置错误，不需要修改项目业务代码，只要把TeamCity代理端的Node版本和完整性修正即可解决。

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