真正能落地的远程子应用加载方案必须遵循“校验→隔离→执行→卸载”四步闭环，且每步可拦截、可观测、可降级；remoteEntry.js需带版本哈希与入口签名，执行前须Proxy隔离全局副作用，错误需分层捕获并携带子应用上下文，卸载须清理DOM、事件、定时器及shared依赖冲突。
直接用 import() 或 document.createElement('script') 加载远程子应用脚本，大概率会出错——不是加载失败白屏，就是样式/事件泄漏、全局变量污染、卸载后内存残留。真正能落地的引导方案，必须把“加载”拆成“校验 → 隔离 → 执行 → 卸载”四步闭环，且每步都可拦截、可观测、可降级。
remoteEntry.js 必须带版本哈希与入口签名
远程子应用的入口文件（如 remoteEntry.js）不能是裸构建产物。Webpack Module Federation 默认生成的 remoteEntry.js 本身不包含版本标识或完整性校验，线上 CDN 缓存、中间代理、HTTP/2 复用都可能导致旧版脚本被复用。
- 构建时强制在
remoteEntry.js文件名中嵌入内容哈希，例如remoteEntry.a1b2c3d4.js，避免缓存污染 - 在脚本末尾注入签名块：
__MF_MANIFEST__ = { version: "2.3.1", timestamp: 1744633200, checksum: "sha256:..." }，主应用加载后先校验再执行 - 拒绝加载无
__MF_MANIFEST__的远程入口，防止被篡改或降级到测试环境产物 - 若校验失败，抛出
RemoteManifestMismatchError，而非静默 fallback —— 这类错误必须进监控告警，不能靠 UI 降级掩盖
加载器必须劫持 remote app 的全局副作用
远程子应用哪怕用了 Module Federation，其生命周期钩子（bootstrap/mount）仍可能调用 document.addEventListener、修改 document.title、写入 localStorage，这些操作一旦发生就逃逸出沙箱边界。
- 在执行
remoteEntry.js前，用Proxy包裹window和document，对敏感 API 做白名单控制 -
addEventListener被调用时，自动绑定{ once: true }，或记录 handler 引用供后续unmount时清除 - 禁止远程脚本访问
window.location、history.pushState等路由相关 API，改由主应用统一透出受控的navigate函数 - 所有动态插入的
<style>或<link rel="stylesheet">必须添加唯一data-remote-id属性，用于卸载时精准移除
超时与错误必须分层捕获，不能只靠 try/catch
import('http://xxx/remoteEntry.js') 抛出的错误类型太笼统：网络中断、CORS 拒绝、JS 语法错误、模块未找到、共享依赖冲突……全挤在同一个 catch 分支里，根本没法做差异化处理。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 网络层超时独立控制：用
AbortController限定 fetch 请求不超过 5s，比import()的 Promise 拒绝更早介入 - 解析执行阶段错误单独捕获：用
eval（需配合 CSP nonce）或Function构造器执行脚本，并用window.onerror+PromiseRejectionEvent监听内部异常 - 明确区分三类错误：
NetworkError（重试）、ParseExecutionError（降级）、VersionConflictError（阻断并告警） - 错误信息必须携带
remoteAppId、entryUrl、sharedDepsDiff字段，方便 APM 系统按子应用聚合定位
卸载逻辑必须清理 DOM、事件、定时器、内存引用
多数方案只调用 unmount，但远程子应用的副作用远不止渲染节点：可能注册了全局 MutationObserver、启动了 WebSocket、设置了 setInterval、甚至保留了对大对象的闭包引用。
- 卸载前主动遍历并清除所有匹配
[data-remote-id="xxx"]的 DOM 节点和<style>标签 - 遍历
window.__MF_HANDLERS__（自定义注册的事件监听器池）逐个removeEventListener - 扫描并清除所有
setTimeout/setIntervalID（可通过重写全局函数打点实现） - 触发
remoteApp.unmount()后，手动将子应用导出对象置为null，协助 GC 回收
最常被忽略的一点：远程子应用的 shared 依赖（如 react、lodash）版本若与主应用不一致，Module Federation 不会报错，而是静默创建两份实例——这会导致 React Context 失效、Hook 状态错乱、内存占用翻倍。必须在加载前比对 shared 清单，并拒绝版本偏差超过 patch 级别的远程应用。
