You need to enable JavaScript to run this app. Angular 11升级Webpack 5后出现chunk.files弃用警告的排查与解决
优惠活动
大模型
产品
解决方案
定价
更多

Angular 11升级Webpack 5后出现chunk.files弃用警告的排查与解决

Angular 11强制使用webpack5出现chunk.files弃用警告的处理方案

基础认知澄清

  • 完全不需要修改你业务代码里的数组逻辑替换为Set
    从你提供的完整调用栈可以确认,触发这个警告的代码路径完全在Angular官方构建工具链内部:是@angular-devkit/build-angular自带的NgBuildAnalyticsPlugin插件,在收集打包统计信息时,沿用了webpack4时代对chunk.files的数组索引访问写法,没有适配webpack5将chunk.files从Array改为Set的API变更。整个触发链路没有涉及你自己写的业务代码,做业务代码的数组替换属于完全多余的操作。
  • 该警告的本质是版本匹配问题
    你通过resolutions强制把webpack升级到5.x版本,但Angular 11配套的@angular-devkit/build-angular版本尚未完全适配webpack5的全量API——Angular官方是从Angular 12版本开始才正式默认接入webpack5作为内置构建依赖的。即使在Angular 11时期开启webpack5的实验特性,也会存在部分构建插件未完全适配的情况,这个警告属于过渡期的兼容性提示,不影响项目的正常构建、启动运行,也不会生成错误的打包产物。

弃用警告追踪参数的配置方式

要获取完整的调用栈定位触发源,可以通过以下任意一种方式配置--trace-deprecation参数:

  • 临时生效:在执行ng build/ng serve的命令后追加参数--node-options="--trace-deprecation",就能直接输出完整的警告触发栈,不需要修改全局Node配置。
  • 项目内固定配置:在项目的package.json的scripts字段里,给对应的构建/启动命令追加上述参数,比如:
    "scripts": {
      "build": "ng build --node-options=\"--trace-deprecation\"",
      "start": "ng serve --node-options=\"--trace-deprecation\""
    }
    
  • 全局生效:在你的终端环境配置文件(如.zshrc、.bash_profile)中新增环境变量配置export NODE_OPTIONS="--trace-deprecation",执行完source生效后,所有启动的Node进程都会自动带上弃用警告追踪参数。

具体处理可选方案

根据你的实际项目情况,可以选择对应的处理方式:

  1. 直接忽略警告
    警告来源是Angular官方构建插件的内部实现,不影响功能使用。如果不想在控制台看到这类冗余提示,可以在启动构建命令时设置环境变量NODE_NO_WARNINGS=1,直接屏蔽所有Node层面的弃用警告输出。
  2. 升级配套构建工具链
    这个问题在Angular的后续版本已经被官方修复:升级到Angular 12及以上的正式版本后,配套的@angular-devkit/build-angular已经完全适配webpack5下chunk.files的Set结构API,不会再触发该警告。
  3. 临时补丁修复插件逻辑
    如果暂时不具备升级Angular大版本的条件,可以通过patch-package这类工具,修改@angular-devkit/build-angular/src/webpack/plugins/analytics.js中对应位置的代码:把原来对chunk.files的数组索引取值逻辑,改为适配Set结构的遍历取值写法,从根源上消除警告触发。

内容的提问来源于stack exchange,提问作者Benjamin Barbé

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 08:45:04