在Angular应用中添加Spartacus遇npm依赖树解析错误求助

问题重现步骤 #

• 创建Angular应用：ng new xyz --style=scss --routing=false
• 添加.npmrc文件
• 执行命令：ng add @spartacus/schematics@6.8.0

执行命令时出现以下错误：

npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: xyz@0.0.0
npm ERR! Found: @spartacus/core@6.3.1
npm ERR! node_modules/@spartacus/core
npm ERR!   @spartacus/core@"~6.3.0" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer @spartacus/core@"6.8.0" from @spartacus/pdf-invoices@6.8.0
npm ERR! node_modules/@spartacus/pdf-invoices
npm ERR!   @spartacus/pdf-invoices@"~6.8.0" from the root project

环境版本信息 #

• Angular CLI: 15.2.10
• Node: 16.13.0
• 包管理器：npm 8.1.0
• 操作系统：darwin arm64

项目package.json内容 #

{  
  "name": "xyz",  
  "version": "0.0.0",  
  "scripts": {    
    "ng": "ng",    
    "start": "ng serve",    
    "build": "ng build",    
    "watch": "ng build --watch --configuration development",    
    "test": "ng test"  
  },  
  "private": true,  
  "dependencies": {    
    "@angular/animations": "^15.2.4",    
    "@angular/common": "^15.2.4",    
    "@angular/compiler": "^15.2.4",    
    "@angular/core": "^15.2.4",    
    "@angular/forms": "^15.2.4",    
    "@angular/platform-browser": "^15.2.4",    
    "@angular/platform-browser-dynamic": "^15.2.4",    
    "@angular/router": "^15.2.4",    
    "@angular/service-worker": "^15.2.4",    
    "@fontsource/open-sans": "^4.5.14",    
    "@fortawesome/fontawesome-free": "5.8.1",    
    "@ng-select/ng-select": "^10.0.3",    
    "@ngrx/effects": "^15.3.0",    
    "@ngrx/router-store": "^15.3.0",    
    "@ngrx/store": "^15.3.0",    
    "@spartacus/asm": "~6.3.0",    
    "@spartacus/assets": "~6.3.0",    
    "@spartacus/cart": "~6.3.0",    
    "@spartacus/checkout": "~6.3.0",    
    "@spartacus/core": "~6.3.0",    
    "@spartacus/order": "~6.3.0",    
    "@spartacus/pdf-invoices": "~6.8.0",    
    "@spartacus/product": "~6.3.0",    
    "@spartacus/smartedit": "~6.3.0",    
    "@spartacus/storefinder": "~6.3.0",    
    "@spartacus/storefront": "~6.3.0",    
    "@spartacus/styles": "~6.3.0",    
    "@spartacus/tracking": "~6.3.0",    
    "@spartacus/user": "~6.3.0",    
    "angular-oauth2-oidc": "^15.0.1",    
    "bootstrap": "^4.6.2",    
    "i18next": "^21.9.1",    
    "i18next-http-backend": "^1.4.1",    
    "i18next-resources-to-backend": "^1.1.2",    
    "ngx-infinite-scroll": "^15.0.0",    
    "rxjs": "^6.6.0",    
    "tslib": "^2.3.0",    
    "zone.js": "~0.13.0"  
  },  
  "devDependencies": {    
    "@angular-devkit/build-angular": "^15.2.4",    
    "@angular/cli": "^15.2.4",    
    "@angular/compiler-cli": "^15.2.4",    
    "@spartacus/schematics": "^6.8.0",    
    "@types/jasmine": "~4.3.0",    
    "jasmine-core": "~4.6.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": "~4.9.4"  
  }
}

解决方案 #

原因分析 #

依赖冲突的核心是：项目中@spartacus/core版本为~6.3.0，但@spartacus/pdf-invoices@6.8.0要求peer依赖@spartacus/core必须为6.8.0，版本不匹配导致npm无法解析依赖树。

修复步骤 #

方案1：统一所有Spartacus包版本为6.8.0

修改package.json中所有@spartacus/*依赖的版本号为~6.8.0（包括@spartacus/core、@spartacus/asm等所有相关包），然后执行：

npm install

方案2：降级@spartacus/pdf-invoices到与core匹配的版本

如果不需要6.8.0版本的pdf-invoices功能，将@spartacus/pdf-invoices的版本改为~6.3.0，然后执行：

npm install

方案3：临时绕过依赖检查（不推荐）

若需临时跳过依赖校验，可执行以下命令，但可能引发运行时兼容性问题，仅建议测试环境使用：

npm install --force

或

npm install --legacy-peer-deps

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