检测 javascript module 缓存泄漏的核心方法是利用 import() 动态导入的返回值,在代码中直接访问 modulemap 或 system.registeredmodules 等内部属性来统计当前缓存的模块数量。通过对比引入新模块前后的计数变化,可以确认是否存在未清理的缓存条目。具体做法是封装一个工具函数,在每次调用 import() 后记录返回的模块标识符,并在需要时检查这些标识符是否仍存在于全局模块注册表中。

如何获取并遍历当前缓存的模块列表
要获取当前缓存的模块列表,最直接的方式是访问浏览器环境下的 globalThis.__vite_ssr_imported_modules__(Vite 环境)或 Node.js 环境下的 module.registeredModules。在标准 ES Modules 环境中,没有公开的 API,但可以通过拦截 import() 调用来手动维护一份映射表。以下代码展示了如何在 Vite 开发环境下获取所有已加载的模块 ID:
const getLoadedModules = () => {
if (typeof globalThis.__vite_ssr_imported_modules__ !== 'undefined') {
return Object.keys(globalThis.__vite_ssr_imported_modules__);
}
// 降级方案:假设有一个手动维护的全局 Map
return window.__customModuleCache ? Array.from(window.__customModuleCache.keys()) : [];
};
console.log('当前缓存模块数:', getLoadedModules().length);运行上述代码会输出当前环境中所有被缓存的模块路径数组。在 Vite 中,每个动态导入的模块都会在该对象中留下痕迹。如果多次调用 import('./heavy-module'),该模块的 ID 只会保留一份,因为它是基于键值对缓存的。因此,单纯的数量增加通常意味着引入了新的、之前未加载过的模块,而不是同一模块被重复缓存。
如何验证特定模块是否被正确缓存而非重复加载
验证模块是否被正确缓存的关键在于观察 import() 返回的 Promise 引用是否一致。如果模块被缓存,第二次调用相同的 import() 应该立即返回同一个 Promise 实例,而不是重新执行模块初始化逻辑。我们可以通过比较两次导入的模块导出对象引用来判断:
立即学习“Java免费学习笔记(深入)”;
async function checkModuleCaching() {
const mod1 = await import('./utils/helper');
const mod2 = await import('./utils/helper');
console.log('是否是同一引用:', mod1 === mod2);
console.log('模块 ID:', mod1[Symbol.toStringTag]);
}
checkModuleCaching();这段代码的执行结果将显示 true,证明模块已被缓存且未重复执行。如果观察到 false,则说明存在自定义的缓存失效机制或模块路径因查询参数不同而被视为不同模块。在实际排查中,应结合网络面板和内存快照,确认模块代码块是否只被下载和执行一次。

动态导入模块后如何手动清理缓存以防止泄漏
在大多数现代运行时中,无法直接删除 import() 缓存中的单个条目,因为这是引擎层面的优化行为。但是,可以通过移除对该模块的所有外部引用,让垃圾回收器回收其占用的内存。对于使用 Vite 等构建工具的项目,可以利用 __vite_ssr_imported_modules__ 进行手动清理。以下代码演示了如何强制清除某个模块的缓存引用:
function clearModuleCache(moduleId) {
if (globalThis.__vite_ssr_imported_modules__) {
delete globalThis.__vite_ssr_imported_modules__[moduleId];
}
// 如果是自定义缓存 Map
if (window.__customModuleCache) {
window.__customModuleCache.delete(moduleId);
}
}
// 示例:在组件卸载时清理
const unloadModule = async () => {
const mod = await import('./heavy-component');
// 执行某些操作...
clearModuleCache(mod.id); // 手动清理
};执行此操作后,再次调用 import() 将会重新加载并执行该模块。这种方法适用于单页应用中需要按需加载且后续不再使用的重型模块。需要注意的是,手动清理缓存可能会破坏依赖关系图,导致其他模块因找不到依赖而报错,因此仅在明确知道该模块不再需要时使用。



















