一、这一篇在处理什么
这一篇只处理一件事:在台湾运行的API 接口站,使用维科云的SDK 盾时,如何处理「崩溃后没有上报」。
崩溃发生在上报之前,或者上报请求本身又触发崩溃。线上只有商店评论,没有堆栈。
看崩溃文件生成数和实际上报成功数的差距。
二、台湾的网络和高峰
晚间高峰集中,整点活动时会有瞬间爬坡。岛内访问和跨境访问差异大。跨境首包变慢时,岛内用户可能仍然正常。
排查时:把台湾岛内和从台湾出去的访问分开统计。只有跨境慢时,不要改岛内源站的业务逻辑。
不要这样做:用台北办公网络代表全部用户。移动网络和办公网络要各测一次。
三、API 接口站要分开的路径
按路径区分只读和写入。只读且不含身份的响应才可以短缓存,写入必须回源。
防护边界:整站跳转和整站挑战不能盖住接口。调用方不会处理跳转到网页的结果。
验证:用固定的样例请求看状态码和正文是否仍是接口格式。失败时日志里要有请求编号,而不是一段网页。
四、SDK 盾怎么接
App 里的登录、下单等关键请求走 SDK 隧道,图片和安装包仍走 CDN。服务端校验时间窗、随机数和签名,不把源站地址写进客户端包。隧道失败时可以降级,但降级必须打点,不能静默改去连源站 IP。
产品说明见SDK 盾。只改和「崩溃后没有上报」有关的域名或路径,不要把API 接口站的其他路径一起改掉。
五、排查步骤
下面五步按因果顺序执行,后一步依赖前一步的结果。步骤针对「崩溃后没有上报」,不是一套通用清单。
- 只读接口和写入接口分成两列。写入请求一律记为不缓存。 岛内访问和从台湾出去的跨境访问分成两张表。 这一故障在本步要完成的事:崩溃时先把堆栈写到本地文件。
- 只读且不含身份的响应才允许短缓存。任何写入都不能被跳转成网页。 只有跨境变慢时,不要修改只服务岛内的程序逻辑。 这一故障在本步要完成的事:下次启动再上传,不要在崩溃现场发起网络请求。
- 挑战和整站跳转排除全部接口路径。需要限速时按路径限速,返回仍是接口格式。 跨境路径单独改调度或回源。岛内解析保持不动。 这一故障在本步要完成的事:上传失败保留文件,不要立刻删除。
- 源站对写入接口做幂等。只读接口不要因为写入故障被一起拒绝。 确认岛内表仍然正常后,再发布跨境这一侧的变更。 这一故障在本步要完成的事:堆栈里去掉令牌和手机号。
- 用一条固定样例请求检查状态码和正文仍是接口数据。失败日志里要有请求编号。 用台湾移动网络和办公网络各测一次,不要只用台北办公室的有线网络。 这一故障在本步要完成的事:用一次测试崩溃验证下次启动能看到记录。
六、处理办法
- 上报走独立的轻量接口。
- 本地文件有数量上限。
- 版本号随堆栈一起上传。
改完后在台湾的用户网络上复查,不要只在机房内网看。复查时带上API 接口站的验证:用固定的样例请求看状态码和正文是否仍是接口格式。失败时日志里要有请求编号,而不是一段网页。
七、案例
一个空指针只出现在崩溃瞬间的网络回调里,原来的上报代码也在这个回调里,所以从未送出。改成下次启动上报后,第二天就收到了堆栈。
若同样的现象出现在台湾,额外核对:把台湾岛内和从台湾出去的访问分开统计。只有跨境慢时,不要改岛内源站的业务逻辑。
业务侧核对:按路径区分只读和写入。只读且不含身份的响应才可以短缓存,写入必须回源。
这个案例只说明怎么定位,不构成容量或可用性承诺。
八、常见问题
问:为什么不能当场上传?
答:崩溃现场内存和网络都不稳定,上传代码可能再次崩溃。
问:用户不重启怎么办?
答:那次崩溃暂时不会上报。本地文件还在,下次启动会补。
问:可以记录请求正文吗?
答:不要。堆栈和请求 ID 足够,正文可能含有令牌。
问:同一故障换一个地区或一种业务,排查还一样吗?
答:不一样。每一步都先按API 接口站的路径处理,再按台湾的网络条件收窄,最后才做「崩溃后没有上报」这一故障本身的动作。换地区或换业务,前两段操作就会变。
九、边界
只讨论SDK 盾在「崩溃后没有上报」上的处理,地区范围是台湾,业务范围是API 接口站。请遵守当地法律。维科云提供网络能力,不对客户业务内容负责。