npm install报未引用Angular组件版本的依赖冲突如何解决？

冲突可能来源 #

• npm 7.x 版本默认启用严格对等依赖解析，且对版本范围^12.0.5的解析会匹配12.x大版本下的最新发布版，若共享库或应用的任意传递依赖允许@angular/common拉取12.x最新版，就会自动解析到12.2.4，和本地已固定的@angular/core@12.0.5产生版本冲突
• 之前npm link测试的缓存残留，导致本地node_modules或npm全局缓存中仍有12.2.4版本的@angular/common包记录，安装时优先命中了缓存版本
• 共享库的package.json配置异常：本地开发时的package.json与推送到Verdaccio的构建产物中的package.json不一致，比如构建脚本自动修改了依赖范围，或者推送时误传了其他分支的配置
• 应用的package-lock.json中已存在@angular/common@12.2.4的锁定记录，之前某次依赖安装时被写入锁文件，后续安装会优先遵循锁文件的版本约束
• 应用中存在未显式声明的第三方传递依赖，该依赖的对等依赖或直接依赖要求@angular/common@12.2.4版本

自行排查方法 #

• 执行npm ls @angular/common命令，查看当前项目中@angular/common的所有版本和完整依赖树，直接定位是哪个包引入了12.2.4版本的@angular/common
• 检查共享库的远程包配置：分别执行npm view @my-comany/my-component-ui@7.0.5 peerDependencies和npm view @my-comany/my-component-ui@7.0.5 dependencies，查看推送到Verdaccio的包实际的依赖声明，确认和本地开发时的配置一致
• 清理本地缓存与无效依赖：执行npm cache clean --force清理npm全局缓存，删除本地的node_modules文件夹和package-lock.json文件后重试安装
• 禁用严格对等依赖解析临时验证：执行npm i @my-comany/my-component-ui@7.0.5 --legacy-peer-deps跳过对等依赖检查，安装完成后再执行npm ls @angular/common定位版本来源
• 检查Verdaccio服务的缓存：确认Verdaccio是否缓存了错误版本的依赖包，可登陆Verdaccio后台查看@angular/common的可用版本列表，确认是否有异常配置

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