前端埋点数据丢失主因是发了但未进后台，常见于断网、页面卸载、高频触发、参数非法或平台拦截；uni.report对null/undefined、非法事件名、超长字符串、超范围数字等静默丢弃；页面卸载时需用sendBeacon（H5）或缓存补报（小程序/App）；高频场景须防抖、限并发、降级；跨端需校验域名、CORS、HTTPS及响应code，真机抓包验证必不可少。
前端埋点数据丢失，不是“没发出去”，而是发了但没进后台——常见于断网、页面卸载、高频触发、参数非法或平台拦截。uni-app 的跨端特性会让这个问题更隐蔽：H5 看着正常，小程序静默丢包，App 端请求被系统回收。
uni.report 为什么传了却没进统计后台
uni.report 是官方推荐的轻量埋点接口，但它对输入极其敏感，不报错也不提示，直接静默丢弃整条事件：
- 参数对象里含
null或undefined值 → 整条丢弃（微信侧最常见） - 事件名含短横线（
'user-login'）、空格或中文 → 小程序原生层直接过滤 - 字符串字段超 256 字符（如长路径、未截断的 error.stack）→ 被截断后校验失败
- 数字超出 JavaScript 安全整数范围（
±9007199254740991）→ 序列化异常导致丢包 - 在
onLoad中立即调用 → 页面未 ready，部分平台不接收
验证方式：真机调试下打开微信开发者工具「调试器 → Console」，手动执行 uni.report('test_event', {a:1})，再查 uni 统计后台是否出现；若无，优先检查参数合法性。
页面卸载时埋点请求被中断
用户点击返回、切到后台、或刷新页面时，XMLHttpRequest 或 uni.request 极易被浏览器/小程序引擎中止，且不触发 fail 回调。
HISUI 前端框架开发指南（IRIS版）
下载
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
立即学习“前端免费学习笔记（深入）”；
- 别用
onUnload或onHide+uni.request上报关键行为（如表单提交完成、视频播放结束） - H5 端必须改用
navigator.sendBeacon()发送离线日志，它异步且不可取消 - 小程序和 App 端无
sendBeacon，需改用本地缓存 + 后续补报：在onHide时uni.setStorageSync('pending_events', [...])，下次onShow或onLaunch时批量重发 - 缓存前做简单去重：用
event_id = Date.now() + Math.random().toString(36).substr(2, 5)防止同一操作重复上报
高频操作导致请求堆积或被限频
按钮连点、列表快速滚动触达多个曝光点、AI 助手连续提问等场景，会瞬间产生大量埋点请求，触发平台限频或本地并发溢出。
- 加 300ms 防抖：同一事件名（如
'button_submit_click'）500ms 内重复触发只保留最后一次 - 限制并发数：封装
trackEvent时用队列控制，最多同时发 2 个uni.request，其余等待 - 网络差时降级：检测
networkType === 'none'，直接写入 localStorage，不发请求 - 避免在
watch或scroll回调里直接上报，先节流再进队列
跨端平台差异导致的“伪成功”
看似 success 回调执行了，但数据根本没进后台——尤其在小程序里，uni.request 成功只代表请求发出了，不代表服务器收到了。
- 小程序必须把
tongji.dcloud.io加入request合法域名白名单，否则请求被拦截且无提示 - H5 端若走
fetch，注意 CORS 配置；App 端若用uni.request，需确认 manifest.json 中已开启 HTTPS 强制校验 - 统一加响应校验：后端返回
{ code: 0 }才算真正成功，否则存为待重试项 - 真机抓包验证：iOS 微信用「腾讯御界」或 Charles（配 SSL 代理），Android 用 Stetho 或 Fiddler，确认请求是否真实发出并收到 200
最容易被忽略的是：参数非法和页面卸载这两个点。前者让埋点“死在出发前”，后者让它“死在半路上”——不验证真机行为，只看控制台 success 日志，等于闭眼开车。
