Angular 8升级至17后启动报错：HookWebpackError文件不存在

是否需要逐步升级？ #

• 更推荐逐步升级。Angular从8到17跨了9个大版本，涉及构建系统（Webpack 4→5+、ESBuild支持）、Ivy引擎强制启用、TypeScript/RxJS版本大幅更新等核心变更。直接跳版本会把多个版本的兼容问题堆在一起，排查难度极大。逐步升级可以跟着官方指南逐个处理每个版本的Breaking Changes，降低风险。
• 但如果已经完成直接升级，没必要回退，优先尝试修复当前报错即可。

直接解决Webpack启动报错（ENOENT: no such file or directory） #

这个错误是Webpack扫描文件时找不到指定路径，且由Compilation.hooks.processAssets插件触发，按以下步骤排查：

1. 校验soap库的适配性
   • 确认soap版本支持Angular 17要求的Node.js 18.13+，避免因库版本不兼容导致文件路径解析异常。
   • 检查代码中使用soap的逻辑，是否存在硬编码的本地文件路径（比如WSDL文件），升级后项目结构变化可能导致路径失效。
2. 彻底清理构建缓存
   • 执行以下命令清除所有缓存与依赖，重新安装：

     rm -rf node_modules package-lock.json
     npm cache clean --force
     npm install
     ng cache clean
     

3. 排查Webpack相关插件
   • 检查package.json中的依赖，移除或升级与Angular 17不兼容的插件（比如旧版本的@angular-builders/custom-webpack、自定义loader等），确保所有插件版本与Angular 17匹配。
   • 如果项目有自定义Webpack配置，检查其中是否有引用不存在的文件或目录，尤其是processAssets钩子相关的逻辑。
4. 检查Angular CLI配置
   • 核对angular.json中的assets配置，确保没有引用不存在的文件/目录：

     "assets": [
       "src/favicon.ico",
       "src/assets"
     ]
     

   • 确认build配置的outputPath目录存在且有读写权限。
5. 校验TypeScript与RxJS版本
   • 确保typescript版本为5.2+（Angular 17强制要求），rxjs版本为7.8+，旧版本的语法或类型定义可能导致构建异常。

额外注意事项 #

• 替换ngx-soap为soap后，要全面适配soap的API，两者调用逻辑差异较大，避免因代码逻辑错误间接引发构建问题。
• 对照Angular官方升级文档，逐一排查每个大版本的核心变更（比如Angular 12移除View Engine、Angular 16引入Signals等），确保项目代码适配这些变更。

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