能复现的 bug 是舒服的那种。会随小程序一起上线的那种,不能:它活在用户的手机上、在一个你没法插桩的宿主 App 里、在一个你没法观测的网络上。等它到你手上时,用户早就关了。2025 年东南亚 89% 的智能手机出货在 200 美元以下——那些机器 RAM 只有 2 到 4 GB,WebView 引擎比主流落后两个大版本。桌上的 iPhone 15 复现不了任何东西。小程序跑在一个你控制不了的宿主里、在一张看不见的网络上,所以「本地复现、修、发」那套舒服的调试,在这里不适用。唯一的证人是设备,你得去找它。

真机远程调试,偏偏在低端机上最飘

Chrome 的远程调试走 ADB,在真实安卓上能跑,但低端机正好是它最不稳的地方:USB 调试会掉线,无线调试加的延迟恰好把竞态藏着,一台电量 2% 的手机还会降频、把你正看的 CPU 曲线也一起降了。能扛住这个的纪律,是从第一天起就把设备当真相源,而不是等模拟器失败后才去够它。某团队的习惯是每台主力低端机型号常备一台,CI 里跑真机回归,而不是只在模拟器上飘。

source map 上线就丢了

第二大坑是栈。本地崩的是 app.js 第 120 行,线上宿主或宿主裁剪之后,回传的崩溃栈是压缩混淆过的,行号对不上。没有 source map 上传和符号化,线上报错就是一团无法定位的乱码。正确做法是构建时把 source map 传到自己的符号服务器,崩溃上报时自动还原到源码行。否则「线上一堆报错、本地什么都查不到」会持续消耗整个团队的耐心。

调试手段桌面低端真机线上
远程断点顺飘、掉线无
崩溃栈源码行源码行需 source map
复现易难靠用户回传

可观测性:让设备自己说话

真正能兜底的,是把崩溃、卡顿、网络失败这些事件在客户端采集后回传到服务端,而不是等用户写工单。某团队靠远程崩溃上报,发现某机型在 WebView 94 上某个特定 API 必崩,而这在他们所有的测试机上一个都没出现。没有这层上报,这个 bug 会一直被当成「个别用户网络问题」。

网络层也要看得见

崩溃只是真相的一半。另一半是网络:哪个宿主、哪种网络制式下,某个接口超时或失败率突增。某团队曾靠客户端上报发现,他们的资源 CDN 在某一运营商的 MTU 设置下大文件必丢,而这件事在他们的 WiFi 测试环境里永远复现不了。把网络失败按宿主、按网络类型、按接口维度采集回服务端,设备才真正替你作证——否则「个别用户网络问题」会一直背这个锅。

日志采样,别全量

低端机的存储和上传都金贵,全量日志会反过来拖垮性能、还吃用户流量。真正能兜底的做法是采样:日常只留关键路径的轻量埋点,崩溃或异常时再附带上报最近一段环形缓冲。某团队把日志从全量改成「常规采样加崩溃附带」,低端机上的性能投诉反而下降,而该抓的 bug 一个没漏。可观测性的目标不是把设备灌满日志,是让那台你拿不到的设备在出事时,能替你说清楚发生了什么。

一句话收尾

小程序的调试,真相源从来不是你的笔记本,而是那台你拿不到的设备。把远程调试、source map、客户端可观测性三件套在开发第一天就铺好,设备才会替你作证。

参考来源