---
name: hotfix-procedure
type: procedure
when: '紧急修复, hotfix, 线上问题修复, 线上报错, 紧急上线, P0, P1, 事故修复, 止血'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-紧急修复流程
asset_kind: procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-delivery-gate
routes:
  - code_change
primary_triggers:
  - 紧急修复流程
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-intent-router
emits:
  - execution_result
  - evidence
required_evidence:
  - execution_evidence
version: 1.0.0
last_reviewed: '2026-05-22'
migration_note: 知识资产标准化迁移
status: active
---

## 适用场景
生产环境出现紧急故障（P0/P1），需要跳过常规流程快速修复。核心原则：先止血再治本。

## 步骤
1. 确认问题影响范围和严重程度，通知相关干系人
2. 评估止血方案：配置回滚 / 功能开关关闭 / 服务降级 / 版本回滚
3. 执行止血操作，确认影响消除或缩小
4. 从 main/release 分支拉取 hotfix 分支
5. 编写最小修复代码（仅修复问题，不重构不优化）
6. 快速验证：修复场景 + 回归核心功能（可缩减测试范围）
7. 合并到 main 和 release 分支，打 hotfix tag
8. 部署到生产环境
9. 验证修复效果，监控 30 分钟
10. 编写事故复盘（根因、影响、修复、预防措施）

## 检查点
- [ ] 止血操作已执行且生效
- [ ] 修复代码仅包含问题修复，无附带变更
- [ ] 核心功能回归通过
- [ ] 事故复盘已记录

## 注意事项
- hotfix 分支必须同时合并回 main（防止下次发版丢失修复）
- 优先考虑回滚而非修复（回滚风险更低）
- 修复后 24 小时内完成事故复盘
