---
title: 应用与数据库 schema 同时升级，如何兼容、灰度和回滚？
description: 通过字段迁移案例理解 expand-migrate-contract、兼容窗口、灰度发布及不可直接回滚的边界。
topic: databases
tags: [database, schema-migration, deployment, rollback]
updated: "2026-11-17"
---

# 应用与数据库 schema 同时升级，如何兼容、灰度和回滚？

[返回题库](../index.md) · [前一题：跨环境晋级](../kubernetes/artifact-promotion.md)

## 题目

应用版本与数据库 schema 同时升级时，如何设计兼容窗口、灰度和回滚？什么情况下不能直接回滚？

## 核心思路

滚动发布时，新旧应用实例可能同时运行，而且通常共用数据库。除了让新代码适配新结构，还必须保证旧代码在共存期间可以读写，并明确新数据出现后允许退回哪个版本。

Schema 指表、字段、类型、索引和约束等数据库结构。应用回滚、结构回滚和数据恢复是不同操作。

## 用字段迁移理解兼容窗口

假设一个发布管理服务原来使用 `status` 表示任务状态，现在要迁移到含义更明确的 `phase`。先假设二者可以无损映射，避免把数据语义变化与字段迁移混在一起。

如果直接重命名字段，滚动发布期间的旧实例仍在读取 `status`，会立即出错。新应用上线后想回退旧应用，也会遇到同样的问题。

常见策略是 **Expand → Migrate → Contract：扩展、迁移、收缩。**

| 阶段 | 数据库与应用操作 | 兼容条件 |
| --- | --- | --- |
| 扩展 | 新增可空的 `phase`，保留 `status` | 原应用仍能读写旧结构 |
| 部署兼容版本 | 仍以 `status` 为准，同时写入 `phase` | 新旧应用可以共存；旧写入方可能使新字段过期 |
| 迁移与验证 | 确认旧写入方退出，分批补齐并校验历史数据 | 所有有效写入路径都维护两个字段 |
| 切换读取 | 逐步改为读取 `phase`，继续维护 `status` | 保留退回兼容版本的能力 |
| 收缩 | 回滚窗口结束后，停止使用并删除 `status` | 此后不再支持依赖旧字段的应用 |

兼容窗口包含新旧应用共存和约定的回滚期限。除了 Web 服务实例，还要覆盖后台消费者、定时任务、长事务、脚本和外部读写方。

删除字段前需要先让所有运行中的代码停止引用它，确认稳定后再执行删除；不要把代码切换和破坏性结构变更压在同一步完成。

## 为什么双写和回填不能只说一句带过？

假设旧实例只更新 `status`，新实例同时更新两个字段。如果先回填 `phase`，随后旧实例又修改 `status`，两个字段就会不一致。此时新代码直接读取 `phase` 会读到过期状态。

一个清晰的阶段划分是：

1. A 版本只读写 `status`。
2. B 兼容版本读取 `status`，在同一事务里更新两个字段。
3. 确认 A 的所有写入方退出后，完成回填与一致性校验。
4. C 版本读取 `phase`，仍维护两个字段。
5. 兼容窗口内支持 C 回滚到 B；如果退回 A，需要重新同步新字段并禁止直接依赖其正确性。

因此，回滚目标要具体到版本及其读写行为，不能笼统地说“随时回上一版”。

回填历史数据时，还需处理：

- **并发写入：** 不要读取旧值后，无条件覆盖已经被应用更新的新值。可采用事务、行锁或版本条件等手段，依据数据库与负载选择。
- **幂等与断点：** 同一批任务重试不应破坏结果，并记录进度。
- **负载：** 分批迁移并限速，观察锁等待、I/O、日志量和复制延迟。
- **完整性：** 不仅检查非空数量，还要验证新旧值映射、遗漏与异常数据。

同一数据库行上的双写可以用一个事务保证原子性；跨数据库或外部系统的双写不能直接套用这个假设，需要额外的一致性与补偿设计。

## 灰度怎样设计？

应用只放 5% 流量到新版，不代表数据库变更只影响 5%。共享数据库的结构变化和锁竞争可能影响所有实例。

可以分阶段推进：

1. 做兼容旧应用的结构扩展，确认执行成本和锁风险。
2. 部署兼容版本，保持新功能关闭，验证原有行为稳定。
3. 完成必要的数据迁移和校验，再按租户、用户或业务对象逐步开启新行为。
4. 验证正确性和性能后扩大范围，保留暂停与回退入口。
5. 回滚窗口结束、旧读写路径退出后，执行结构清理。

功能开关把“新代码部署”与“新行为启用”分开。涉及写入时，按租户或业务对象稳定分组，通常比逐请求随机切换更容易控制新旧逻辑交互。

但关闭开关不会自动撤销已写入的数据。如果新功能产生旧版本无法识别的状态，即使功能关闭，仍可能需要修复数据。

观察指标至少包括：应用错误率和延迟、关键业务结果、数据库锁等待和慢查询、连接数、复制延迟，以及新旧数据一致性。

## 结构迁移本身也有运行风险

“向后兼容”描述的是逻辑兼容性，不意味着执行 DDL 没有风险。建索引、增加约束、设置默认值或改变字段类型，可能锁表、扫描或重写大量数据；实际行为取决于数据库版本和语句。

发布前应在有代表性的数据规模下评估耗时与锁影响。迁移应由受控的单一执行流程负责，避免每个应用副本启动时同时抢着改表。需要明确超时、失败重试、部分完成后的状态以及是否支持事务回滚，不能假设所有 DDL 都可事务回滚。

## 应用、schema、数据分别怎样回滚？

| 对象 | 常见处理方式 | 边界 |
| --- | --- | --- |
| 应用 | 关闭新功能，或部署经过验证的兼容旧版本 | 旧代码必须能理解当前结构和数据 |
| Schema | 兼容性扩展通常先保留；需要时单独评估反向迁移 | 删除新字段可能丢数据，不应随应用回滚自动执行 |
| 数据 | 按变更设计修复、补偿、重放或恢复 | 不可逆转换和外部副作用无法靠代码回退解决 |

例如 C 版本读新字段时出现 bug，但旧字段仍正确维护，就可以回退 B；数据库里的新字段可以继续保留。

发布记录应保存应用版本、迁移状态、功能开关、数据校验结果和最早兼容的回滚版本。每完成一次破坏性变更，都要重新判断回滚边界。

## 什么情况下不能直接回滚？

| 情况 | 具体例子 | 应考虑的处理 |
| --- | --- | --- |
| 旧结构已删除或不兼容 | 删除旧代码依赖的列，改变其不支持的类型 | 先恢复兼容结构与数据，或发布修复版本 |
| 新数据超出旧代码理解范围 | 写入新的状态枚举，旧代码无法处理 | 阻止继续写入，修复数据或提供兼容代码 |
| 转换丢失信息 | 多个状态合并为一个、文本截断、历史记录删除 | 评估从备份或变更日志找回，无法凭反向 SQL 自动还原 |
| 已产生外部副作用 | 消息已消费、设备升级已触发、款项已支付 | 设计业务补偿、幂等处理或人工干预 |
| 恢复备份会覆盖有效新写入 | 发布后其他用户的正常操作也被整库回退 | 评估数据损失，考虑隔离恢复后提取数据、修复或重放 |

整库恢复属于需要明确恢复目标和数据损失范围的操作。即使数据库支持时间点恢复，也需要判断恢复点之后的有效操作如何处理，以及其他系统是否仍与恢复后的数据库一致。

因此，备份与恢复演练不可缺少，但不能把“有备份”当作每次应用发布都可无损回滚的保证。很多故障更适合暂停功能并向前修复。

## 常见误区

- **所有旧 Pod 下线就可以删字段。** 可能还有定时任务、消费者、脚本或回滚需求。
- **数据非空就证明回填成功。** 还要验证数据新鲜度、映射关系和并发一致性。
- **灰度流量小就不会影响全库。** DDL 锁和共享资源竞争仍可能影响所有请求。
- **迁移工具提供 down 命令就能安全回滚。** 反向操作可能丢数据，也无法撤销业务副作用。
- **关闭功能开关即可恢复旧状态。** 新版本已经写入的数据可能需要单独处理。

## 面试回答示例

> 我会将应用升级与数据库迁移分为扩展、迁移、收缩三个阶段。先增加兼容旧代码的结构，再部署兼容读写版本，确认旧写入方退出后分批迁移并校验数据，通过功能开关逐步启用新行为。兼容窗口内保留旧字段和旧数据语义，并明确允许回退的版本。灰度除了观察应用指标，也要看数据库锁、复制延迟和数据一致性。回滚优先关闭功能或退回兼容应用，不自动执行破坏性反向迁移。若旧字段已删除、数据转换不可逆、旧代码无法识别新数据，或者已产生外部副作用，就需要修复、补偿或恢复方案，不能直接回滚代码。

## 延伸问题

- 大表回填怎样做到可重试，同时避免覆盖并发更新？
- 旧消费者仍可能运行，如何证明某字段已经没有读写方？
- 如果新旧字段不能无损映射，应该怎样限制功能开启与回滚？
- [如何通过恢复演练验证备份实际可用，并确认 RPO/RTO？](backup-recovery.md)
