修改WebPack插件调整Angular Chunk的deferred-modules指向解决多Chunk id冲突
Webpack 自定义Chunk插件修改实现方案
现有逻辑的核心问题
- 硬编码仅处理
name === 'main'的单chunk场景,多自执行chunk场景下无法覆盖其他需要处理的chunk实例 - 依赖Webpack默认生成的薄引导模块(即固定id为
0、仅做module.exports = __webpack_require__(主模块)的包装模块)作为deferred列表的执行入口,多个chunk都会生成id为0的引导模块,直接造成全局模块ID冲突 - 代码存在变量作用域重名问题,循环内部定义的
chunk变量会覆盖外层的目标chunk引用,导致runtime删除逻辑经常无法正常触发 - 仅在main chunk所属的group内查找并删除runtime chunk,其他chunk关联的runtime分支无法被清理,导致最终输出的deferred列表始终混入
runtime标识
关键修改动作
- 全量遍历所有满足自执行要求的chunk,不再限定单
mainchunk - 为每个薄引导模块分配全局唯一的自增模块ID,从根源上避免重复0的ID冲突
- 直接将每个chunk对应的主业务模块ID写入deferred模块列表,替代原来固定的
0入口 - 全量扫描每个chunk绑定的所有chunk group,清理所有关联的runtime chunk引用,保证deferred列表不再混入runtime标识
修改后的完整插件代码
// 全局自增计数器,保证引导模块ID不重复 let uniqueModuleIdCounter = 0; export class ChunkIdPlugin { /** * @param selfExecute 是否允许chunk自执行 * @param chunkIdMap 自定义chunk ID映射表,key为chunk name,value为目标chunk id */ constructor(private selfExecute: boolean = false, private chunkIdMap: Record<string, string | number> = {}) {} public apply = (compiler: Compiler): void => compiler.hooks.compilation.tap("ChunkIdPlugin", (compilation) => { // 自定义模块ID生成规则,解决多引导模块ID重复问题 compilation.hooks.moduleIds.tap("ChunkIdPlugin", (modules) => { for (const module of modules) { // 仅处理薄包装的引导模块(即原来id为0的自执行入口) if (module.constructor.name === "EntryModule" && module.dependencies.length === 1) { module.id = `entry-wrapper-${uniqueModuleIdCounter++}`; } } }); compilation.hooks.beforeChunkIds.tap("ChunkIdPlugin", this.iterateChunks.bind(this, compilation)); }); private iterateChunks = (compilation: compilation.Compilation, chunks: compilation.Chunk[]): void => { // 遍历所有需要处理的chunk,不再硬编码仅匹配main for (const targetChunk of chunks) { // 按配置映射chunk ID if (this.chunkIdMap[targetChunk.name]) { targetChunk.id = this.chunkIdMap[targetChunk.name] as any; } // 按原逻辑控制自执行开关 if (!this.selfExecute || targetChunk.groupsIterable.size < 1) { targetChunk.entryModule = undefined; } // 定位当前chunk对应的主业务模块 const mainModule = targetChunk.getModules().find(mod => mod !== targetChunk.entryModule && !mod.constructor.name.includes("RuntimeModule") ); if (!mainModule) continue; // 遍历当前chunk绑定的所有分组做清理 for (const group of targetChunk.groupsIterable) { // 清理当前group里的runtime chunk,避免变量重名问题 const runtimeChunk = group.chunks.find(_ => _.name === 'runtime'); if (runtimeChunk) { group.removeChunk(runtimeChunk); } // 关闭runtime依赖注入 group.options.runtime = false; group.options.entryOptions.dependOn = []; // 覆写chunk的deferred依赖列表,替换原有runtime和引导模块的引用 const dependentModules = Array.from(compilation.chunkGraph.getChunkEntryDependentModulesIterable(targetChunk)); dependentModules.splice(0, dependentModules.length, mainModule); } } } }
输出效果说明
修改后最终打包输出的webpackJsonp.push结构会完全匹配目标要求:
- 第三参数deferred列表不再包含
runtime标识 - 不再使用固定id为
0的引导模块作为自执行入口,直接指向对应chunk的主业务模块ID - 多chunk并行输出时,每个引导模块的全局ID唯一,不会出现ID重复冲突
配置注意点:
- 初始化插件时传入的
chunkIdMap需要为每个独立chunk配置全局唯一的chunk ID,避免chunk层面的ID重复- 多chunk场景下不需要手动拆分runtime配置,插件会自动清理所有输出产物里的runtime引用
内容的提问来源于stack exchange,提问作者John。
相关产品推荐
相关产品推荐

