原生移动开发 / 系统课时
处理线上紧急版本故障
处理线上紧急版本故障
线上版本出现崩溃、登录失败或核心交易异常时,目标不是“马上再传一个包”,而是先控制影响,再用可追踪的新版本完成修复、签名、验证和重新发布,避免在压力下制造第二次事故。
学习目标
- 判断何时应暂停放量、启用服务端缓解或启动客户端紧急修复
- 正确递增
versionCode,生成新的 Release 构建并完成最小回归验证 - 建立从故障确认到重新审核、放量和监控的闭环
先控制影响,再决定是否发热修
确认线上故障后,先回答三个问题:影响哪些版本、影响哪些用户、是否能通过服务端手段立即缓解。若正在分阶段发布且问题与新版本明显相关,应优先停止继续扩大覆盖;若应用已有功能开关、远程配置或服务端降级能力,可先关闭高风险功能。
如果问题只能通过客户端代码修复,就进入 hotfix 流程。不要把“重新发布旧包”当成回滚方案:应用商店中的更新版本需要使用新的版本标识。以 Android 常规发布为例,新包应保持原应用身份与签名连续性,并使用更高的 versionCode。

从生产基线制作新的修复版本
紧急修复应尽量从当前线上版本对应的提交或维护分支开始,只包含与事故直接相关的修改。不要顺手合入大功能、依赖升级或重构,否则会扩大回归面,也会让审核失败或二次故障更难定位。
片段示例:以下配置位于应用模块的 build.gradle.kts 中,具体数字应按团队已有版本策略递增。
android {
defaultConfig {
versionCode = 42018
versionName = "4.2.1"
}
}这里真正决定 Android 更新顺序的是 versionCode;versionName 主要用于面向用户展示。即使修复内容只是恢复旧逻辑,也要把它打成新的、更高 versionCode 的发行版本。
构建并做最小必要验证
完成修复后,用与正式发布一致的构建任务生成 Release AAB。示例假设项目使用 Gradle Wrapper,且签名配置已经通过安全方式注入。
./gradlew clean bundleRelease预期输出
BUILD SUCCESSFUL in <TIME>实际耗时和附加任务输出会不同。构建成功只说明产物生成完成,不代表故障已经修好;至少还要在接近生产的设备与账号条件下复现原问题并确认其消失,同时覆盖启动、登录、核心业务路径和升级安装。
重新提交时保留可追踪信息
提交紧急版本前,把故障单、修复提交、versionCode、versionName、AAB 校验值、签名身份、测试结论和发布渠道关联起来。应用商店若要求重新审核,应按正常更新流程提交,不要假设“紧急”一定会绕过审核。
发布说明应准确描述用户可见的修复,不要写内部敏感信息。若商店支持分阶段放量,可先向较小比例用户发布,并同时观察崩溃率、ANR、登录成功率和核心业务指标;确认稳定后再扩大范围。
故障关闭以线上指标为准
紧急版本通过审核并不等于事故结束。应确认新版本已经真实到达用户、故障指标回落、核心链路恢复,并记录仍停留在旧版本的用户比例。只有技术指标和业务指标都恢复到可接受范围后,才能关闭事故并把这次 hotfix 纳入正常发布档案。