Angular编译初始化失败：GitHub Actions更新AWS项目异常

问题背景 #

在Linux AWS服务器上通过GitHub Actions执行ng build构建Angular 17项目时，出现「Angular compilation initialization failed [plugin angular-compiler]」错误，具体提示Cannot resolve type entity i1.BidiModule to symbol。但删除项目重新从GitHub拉取后，流水线可正常运行。

报错日志 #

ng build
out: #12 1.914 - Building...
out: #12 1.914 
out: #12 7.677 Application bundle generation failed. [5.760 seconds]
out: #12 7.677 
out: #12 7.709 ✘ [ERROR] Angular compilation initialization failed. [plugin angular-compiler]
out: #12 7.709 
out: #12 7.709   Error: Cannot resolve type entity i1.BidiModule to symbol
out: #12 7.709       at reflectTypeEntityToDeclaration (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-6IQBXGRH.js:727:11)
out: #12 7.709       at extraReferenceFromTypeQuery (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:1472:26)
out: #12 7.709       at file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:1467:12
out: #12 7.709       at Array.map (<anonymous>)
out: #12 7.709       at extractReferencesFromType (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:1463:23)
out: #12 7.709       at DtsMetadataReader.getNgModuleMetadata (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:1669:16)
out: #12 7.709       at MetadataDtsModuleScopeResolver.resolve (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:3886:37)
out: #12 7.709       at MetadataDtsModuleScopeResolver.resolve (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:3908:33)
out: #12 7.709       at StandaloneComponentScopeReader.getScopeForComponent (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-LHQ7WPU2.js:2678:52)
out: #12 7.709       at CompoundComponentScopeReader.getScopeForComponent (file:///app/node_modules/@angular/compiler-cli/bundles/chunk-7OQMTKOE.js:3851:27)

package.json配置 #

{
  "name": "ecommerce-angular",
  "version": "0.0.0",
  "scripts": {
    "ng": "ng",
    "start": "ng serve",
    "build": "ng build",
    "watch": "ng build --watch --configuration development",
    "test": "ng test",
    "serve:ssr:Ecommerce-Angular": "node dist/ecommerce-angular/server/server.mjs"
  },
  "private": true,
  "dependencies": {
    "@angular/animations": "^17.0.0",
    "@angular/common": "^17.0.0",
    "@angular/compiler": "^17.0.0",
    "@angular/core": "^17.0.0",
    "@angular/forms": "^17.0.0",
    "@angular/material": "^17.3.2",
    "@angular/platform-browser": "^17.0.0",
    "@angular/platform-browser-dynamic": "^17.0.0",
    "@angular/platform-server": "^17.0.0",
    "@angular/router": "^17.0.0",
    "@angular/ssr": "^17.0.1",
    "@microsoft/signalr": "^7.0.14",
    "express": "^4.18.2",
    "jquery": "^3.7.1",
    "lazyload-image": "^2.2.0",
    "mime": "^4.0.1",
    "ng-lazyload-image": "^9.1.3",
    "ngx-toastr": "^18.0.0",
    "rxjs": "~7.8.0",
    "tslib": "^2.3.0",
    "zone.js": "~0.14.2"
  },
  "devDependencies": {
    "@angular-devkit/build-angular": "^17.0.1",
    "@angular/cli": "^17.3.4",
    "@angular/compiler-cli": "^17.0.0",
    "@types/express": "^4.17.17",
    "@types/jasmine": "~5.1.0",
    "@types/jquery": "^3.5.29",
    "@types/node": "^18.18.0",
    "@types/slick-carousel": "^1.6.40",
    "jasmine-core": "~5.1.0",
    "karma": "~6.4.0",
    "karma-chrome-launcher": "~3.2.0",
    "karma-coverage": "~2.2.0",
    "karma-jasmine": "~5.1.0",
    "karma-jasmine-html-reporter": "~2.1.0",
    "typescript": "~5.2.2",
    "vite": "^4.5.0"
  }
}

可能的原因及解决方案 #

1. 依赖缓存不一致 #

GitHub Actions更新项目时，残留的旧node_modules、package-lock.json或构建缓存可能导致Angular编译器无法正确解析BidiModule（属于@angular/cdk/bidi，是Angular Material的依赖）。

• 解决办法：在流水线中添加清理步骤，确保构建环境干净：

  rm -rf node_modules package-lock.json dist src/tsconfig.tsbuildinfo
  npm install
  

  或者直接用ng build --clean强制清理旧构建产物。

2. Angular版本不匹配 #

项目中Angular核心包（17.0.0）与Angular Material（17.3.2）版本差过大，同大版本内的小版本差异可能引发依赖解析异常。

• 解决办法：统一所有Angular相关包的版本，比如将核心包升级到17.3.2：

  npm install @angular/animations@17.3.2 @angular/common@17.3.2 @angular/compiler@17.3.2 @angular/core@17.3.2 @angular/forms@17.3.2 @angular/platform-browser@17.3.2 @angular/platform-browser-dynamic@17.3.2 @angular/platform-server@17.3.2 @angular/router@17.3.2 @angular/ssr@17.3.2 @angular-devkit/build-angular@17.3.2 @angular/compiler-cli@17.3.2
  

3. 类型定义文件损坏 #

旧的.d.ts类型缓存文件可能损坏，导致编译器无法识别BidiModule的类型实体。重新拉取项目时会生成全新的类型文件，所以能正常构建。

• 解决办法：构建前删除src/tsconfig.tsbuildinfo和dist目录，避免残留旧类型定义。

4. 模块导入路径错误 #

项目中可能存在BidiModule的错误导入方式（比如别名或相对路径错误），在缓存环境下路径解析出现异常。

• 解决办法：检查所有导入BidiModule的代码，确保使用正确的绝对路径：

  import { BidiModule } from '@angular/cdk/bidi';
  

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