升级前备份与恢复检查

升级前 30 分钟检查表

1. 确认本次发布的版本号、发布时间和变更说明，前端、后端镜像及许可证登记版本必须来自同一次发布。
2. 在系统中创建应用备份，并在部署层保存数据库服务或数据卷快照。
3. 记录当前镜像标识、环境配置、数据库版本、备份文件校验信息和负责人。
4. 确认服务器剩余磁盘空间足以同时容纳旧镜像、迁移临时文件和新备份。
5. 在隔离副本中完成恢复和升级演练，确认旧备份确实能打开，而不是只看到“下载成功”。
6. 选择业务低峰期，通知门店停止新增业务，并明确失败后的回滚负责人和判断时间。

备份范围

应用备份、数据库快照、上传文件和部署配置承担不同作用。数据库快照不能替代应用层恢复验证；只保存应用文件也无法恢复完整业务数据。密钥和第三方凭证必须按安全制度单独保管，不要写入公开文档或普通工单。

执行升级

先停止新业务写入，再按发布说明更新服务并执行数据库迁移。观察健康检查和迁移日志，任何迁移失败都应停止继续重试；先保存完整日志并判断数据库是否已经部分变更，再选择修复或回滚。

升级后抽查

依次检查健康状态、登录、许可证、经营模式和门店权限，再使用测试数据抽查销售、采购、库存、茶馆、会员、财务、物流和打印。重点确认数据库版本与应用版本一致，旧业务能查询，新业务能完成闭环。

什么时候必须停止上线

恢复演练失败、数据库迁移报错、前后端版本不一致、登录或门店隔离异常、核心流水无法生成时，都不能继续开放营业。不要反复执行升级命令或用清空数据解决迁移问题；保留日志、请求编号、迁移版本和备份时间后进入回滚流程。