Ionic应用执行ionic serve启动失败，请求协助排查解决

错误信息 #

./src/main.ts - Error: Module build failed (from ./node_modules/@ngtools/webpack/src/ivy/index.js):
[ng] Error: Emit
./src/polyfills.ts - Error: Module build failed (from ./node_modules/@ngtools/webpack/src/ivy/index.js):
[ng] Error: Emit
Error: Failed to initialize Angular compilation - Cannot read properties of null (reading 'fileName')

环境版本 #

• Ionic: 6.20.1
• Angular CLI: 14.1.0
• Node: 16.15.0
• npm: 8.5.5

解决方案 #

1. 清理缓存与依赖 #

• 删除依赖文件夹和锁文件：

  rm -rf node_modules package-lock.json
  

• 重新安装依赖：

  npm install
  

• 强制清理Angular缓存：

  ng cache clean --force
  

2. 验证Angular配置路径 #

检查angular.json中projects对应项目的architect -> build -> options配置，确保main和polyfills的文件路径正确无误：

"main": "src/main.ts",
"polyfills": "src/polyfills.ts"

3. 匹配@ngtools/webpack版本 #

错误源于@ngtools/webpack模块，安装与Angular CLI 14.1.0兼容的版本：

npm install @ngtools/webpack@14.1.0 --save-dev

4. 检查TypeScript配置 #

确认tsconfig.json的compilerOptions符合Angular 14的要求，关键配置示例：

"target": "ES2020",
"module": "ES2020",
"moduleResolution": "node",
"strict": true

5. 修复Ionic项目配置 #

执行Ionic内置修复命令，自动修正项目配置问题：

ionic repair

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