JavaScript 中怎么在微前端或模块化系统中统一管控全局异常流转-js教程-PHP中文网

统一管控全局异常需收口、隔离、透传：覆盖同步错误、全局脚本、promise拒绝、资源加载四类入口；子应用注入app/insandbox上下文并清洗堆栈；主应用按类型决策拦截、重载或降级，并与请求层、状态管理联动。

javascript 中怎么在微前端或模块化系统中统一管控全局异常流转

在微前端或模块化系统中统一管控全局异常流转，关键不是“加一层监听”，而是让异常从子应用、主应用、共享库三个层面，自然汇入同一个处理管道。核心在于收口、隔离、透传三件事。

微前端场景下，异常来源更分散：子应用独立运行、沙箱隔离、跨域资源、样式冲突都可能触发错误。必须覆盖四类入口：

同步执行错误：每个子应用的 entry 脚本、生命周期钩子（如 mount/unmount）需包裹 try-catch，并调用统一上报函数，不直接 console 或 throw
全局脚本错误：主应用注册 window.addEventListener('error')，注意禁用默认行为（e.preventDefault()），避免被沙箱拦截；子应用若脱离沙箱运行（如 legacy 模式），也需各自注册但指向同一 handler
未处理 Promise 拒绝：主应用监听 unhandledrejection，子应用无需重复监听；若子应用使用自己的 Promise 封装（如自定义 fetch wrapper），需确保 reject 后不吞错误，最终交由主应用兜底
资源加载失败：监听 document.addEventListener('error', e => {...}, true) 捕获 img/script/link 加载失败，提取 e.target.src 或 e.target.href，标记为 resource_error 类型

子应用报错不能只传原始 error 对象，否则无法区分是 qiankun 子应用、micro-app 还是主应用自身问题。需自动注入可识别的上下文字段：

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

添加 app: 'sub-react-app' 字段，取自子应用注册时的 name 或 activeRule 匹配结果
记录 inSandbox: true/false，用于判断是否受 proxy 沙箱影响（比如 eval 报错堆栈会被重写）
对子应用内错误堆栈做轻量清洗：移除沙箱代理层（如 at Object.<anonymous> (sandbox.js:123)</anonymous>）、截断 node_modules 行，保留业务代码关键帧
若子应用支持传入自定义 errorHandler（如通过 props 注入），主应用需提供标准接口，要求其返回标准化 error payload，而非自行上报

异常流转不是单向上报，而是支持“主应用决策 → 子应用响应 → 用户反馈”闭环：

主应用统一 handler 中，根据 error 类型和 app 字段决定是否拦截：如 Script error. + 跨域 script，标记为 cross_origin_js 并跳过用户提示；而 TypeError: Cannot read property 'xxx' of undefined 则触发子应用级 reload 提示
提供 triggerAppReload(appName) 接口供 handler 内部调用，由主应用协调子应用卸载/重挂载，避免子应用自己强制刷新导致主应用状态丢失
当上报通道不可用（如网络中断、sendBeacon 失败），将错误暂存内存队列（最多 20 条），并在下一次页面可见（document.visibilityState === 'visible'）或网络恢复时重试
对高频相同错误（5 分钟内 message + stack hash 相同）仅上报首次，后续仅本地 console.warn 并计数，防止日志风暴压垮监控服务

异常流不能脱离现有模块化体系独立存在。要和请求层、状态管理打通：

请求模块（如封装的 fetch）在 4xx/5xx 响应时，不直接 throw，而是生成 BusinessError 实例，携带 requestId、url、method，交由统一 handler 处理，实现“请求失败→错误归因→用户提示”链路可追溯
状态管理模块（如 localStorage 同步器）在持久化失败时，抛出带 stateKey: 'userToken' 的错误，统一 handler 可据此触发登录态清理 + 跳转登录页
所有业务模块调用 logger.error() 时，底层自动附加当前路由、用户角色、设备 UA，避免人工拼接遗漏

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南