JSBridge回调丢失是系统性风险，需分层设计防丢、可溯、可控机制：识别页面跳转、低端Android/WKWebView、高频点击三类高危场景并前置拦截；采用带状态的异步重试，生成唯一requestId并维护上下文；Native层主动兜底，配合超时通知与待确认队列；强化可观测性，支持TraceId全链路追踪与幂等降级。
JSBridge事件丢失不是偶发异常，而是混合开发中因生命周期、线程、时序和平台差异叠加导致的系统性风险。重试机制不能简单“多调几次”，必须结合丢失根因分层设计——既要防丢，也要可溯，还要可控。
识别高危场景，前置拦截重试
盲目重试会放大问题。应先在调用侧识别三类高危信号，触发差异化策略：
-
页面即将跳转或销毁时：监听
beforeunload或Vue/React的beforeUnmount，对未完成的callbackId打标并暂停新调用 -
低端Android（4.x）或WKWebView环境：UA检测后自动启用双通道：URL Scheme +
evaluateJavascriptfallback - 连续点击或高频调用：用节流+唯一ID去重，避免生成重复callbackId导致Native端覆盖回调入口
带状态的异步重试：不只重发，还要续命
标准重试只重发请求，但JSBridge丢失常发生在“已发未回”阶段。需维护调用上下文状态：
- 每次
callNative生成[时间戳+随机数+页面路径哈希]作为全局唯一requestId，而非仅依赖callbackId - 将请求参数、超时时间、重试次数、当前重试状态（pending/failed/retrying）存入内存Map或WeakMap，绑定到组件实例
- 重试时携带
requestId和retryCount，Native层可据此判断是否为重复请求，避免副作用（如重复拍照、重复支付）
Native层协同：从“被动响应”到“主动兜底”
前端重试必须有Native配合，否则可能永远等不到回调：
- Android端在
shouldOverrideUrlLoading拦截失败后，主动触发webView.evaluateJavascript("window.__jsbridge?.onTimeout('xxx')", null) - iOS WKWebView中，利用
messageHandler超时未收到JS响应时，反向postMessage通知JS端“本次调用已超时，无需等待” - Native统一维护一个“待确认队列”，对15秒无响应的请求主动上报埋点，并支持后台静默重执行（仅限幂等操作，如获取用户信息）
可观测与降级：让重试真正可调试、可收敛
没有日志的重试等于盲跑。每个环节需暴露关键信号：
- 前端注入
window.__jsbridgeDebug = true后，所有调用/重试/超时事件输出结构化console，含requestId、堆栈、设备信息 - 对非幂等操作（如拍照、支付），重试上限设为1次，失败后立即走降级路径（如H5模拟相机、跳转Web支付）
- 按
requestId聚合前端日志与Native端操作日志，通过TraceId串联全链路，快速定位是卡在JS→Native、Native执行中、还是Native→JS返回阶段
