Angular升级至14后导入内部库出现子模块找不到错误

核心问题 #

错误提示明确说明razor-client-tagging-lib库依赖的xlsx模块未被找到，这是因为升级后的Angular项目中未安装该依赖，而新建的Angular 14项目可能因环境差异（如npm版本、自动依赖安装机制）自动补全了这个依赖。

解决方法 #

• 手动安装缺失的依赖
  在项目根目录执行命令安装xlsx：

  npm install xlsx
  

  安装完成后重新运行ng serve，验证问题是否解决。

• 协调内部库修复依赖声明
  联系开发razor-client-tagging-lib的团队，确认该库是否将xlsx正确声明为peerDependencies。如果库的package.json中把xlsx放在dependencies或devDependencies里，会导致依赖嵌套安装，在Angular升级后的项目环境中可能无法被正确识别。将其移至peerDependencies后，安装库时会提示用户安装对应依赖，避免此类缺失问题。

• 配置Angular允许CommonJS依赖
  如果安装xlsx后仍有构建警告或错误，需在angular.json的项目构建配置中添加允许CommonJS模块：
  找到projects->[你的项目名]->architect->build->options，添加：

  "allowedCommonJsDependencies": [
    "xlsx"
  ]
  

  这是因为Angular 14对CommonJS格式的第三方模块限制更严格，显式声明允许后可消除相关构建问题。

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