Vibe Coding 数据库与应用发布编排：迁移、代码和回填按什么顺序走

AI 很容易在一个补丁里同时生成新列、ORM 类型、写入逻辑、数据回填和删除旧列。代码审阅时它们像一个完整功能，发布时却是五个不同状态：迁移作业可能先于实例完成，滚动过程中旧新代码会并存，回填可能运行数小时，约束验证和删除又可能持锁。把整个 PR 当作一个原子部署，是数据库发布事故的常见起点。

Vibe Coding Expand-Contract 数据库迁移解释如何设计兼容 schema；本文不重复模式定义，而是把已经选定的兼容步骤排进真实发布运行手册。目标是每一阶段都能回答：当前 schema 是什么、哪些 reader/writer 活跃、历史行覆盖到哪里、下一阶段的前置条件是否已满足。

先建立四方兼容矩阵

发布前列出旧应用、候选应用、扩展后 schema 和收缩后 schema。对每个组合检查启动、读取、写入、回放旧任务和失败语义。至少要证明：旧应用能在扩展 schema 上继续工作；候选应用在回填未完成时能读旧行；新写入不会让旧 reader 崩溃；回滚到旧应用时不会误读新格式。只验证“候选 + 最终 schema”会漏掉滚动发布真正经历的中间组合。

把 schema 版本写成数据库中的可查询迁移水位，但应用不要只看一个数字就假定数据已完成。DDL 已应用、回填已覆盖、双写已对账、约束已验证是四个不同事实。阶段收据保存迁移文件摘要、执行工具版本、目标数据库身份、开始结束时间、锁与错误摘要、行覆盖水位和审批人。

Prisma 的生产迁移工作流用 migrate deploy 应用待执行迁移；它不会替项目判断 DDL 是否会长时间持锁、数据回填是否完成或旧实例是否兼容。PostgreSQL 的 ALTER TABLE 子命令取得的锁级别和是否需要扫描表取决于具体操作。发布手册必须按实际数据库版本、表规模和语句查当前官方文档并在代表性副本演练，不能让模型用一句“ALTER 很快”代替测量。

用阶段门编排发布

第一阶段是扩展：增加向后兼容的列、表、索引或接受逻辑，不删除旧表示。迁移作业必须单实例执行并有并发围栏，失败时保留明确水位；应用实例在 schema 未到最低版本时失败关闭。第二阶段部署兼容 reader：候选能读取旧表示和新表示，遇到未回填行走显式兼容路径，同时继续让旧实例工作。

第三阶段才切换 writer。若采用双写，定义哪个字段是当前事实、写入失败如何处置、怎样对账，而不是简单吞掉第二次写错。每次写入带格式代际，后台任务也固定自己接受的版本。跨服务消费者的升级顺序可参考Schema Registry 消费者兼容发布，HTTP 或消息接口则由Agent API 契约兼容门约束。

第四阶段回填历史数据。回填按稳定主键分片，记录扫描上界、成功、跳过、冲突和重试，不与在线写互相覆盖。若在线数据会继续变化，使用版本条件或对账代际拒绝陈旧写。大规模回填与切换的证据设计可借鉴数据 Backfill 代际切换。覆盖率不能只用“处理行数 / 当前总行数”，还要解释新增、删除、空值豁免和失败集合。

第五阶段验证新约束和读路径。先以不阻断方式发现违规，再清零明确范围内的冲突，最后启用约束；具体能力依数据库而定。第六阶段停止旧写、观察旧读归零，经过承诺窗口后才删除旧字段或兼容代码。删除前保存仍活跃的旧实例、任务、脚本和离线消费者清单，未知消费者不是零消费者。

为回退和向前修复保留窗口

扩展阶段通常允许应用回退，因为旧代码仍认识旧表示；writer 切换后，旧代码是否可回退取决于它能否容忍新写入；删除或不可逆转换后，代码回退可能已经不安全。因此每一阶段分别写 rollbackCode、pauseMigration、resumeBackfill 和 rollForward，不要只留一条“revert PR”。通用迁移基础可查数据库迁移管理，但本次决定必须绑定实际语句和数据。

若错误发生，先冻结新阶段和新 writer，确认已提交的数据代际，再选择回退流量、恢复兼容 reader或向前修补。不要在不清楚水位时反向运行自动 down；删除列、压缩值域或重写数据可能已经丢失信息。Kubernetes 显示应用 rollout 回退成功，也不代表数据库状态随之回退。

发布完成条件不是迁移命令退出零，而是：所有活跃实例达到批准版本；读写兼容矩阵在目标环境成立；回填失败集合清零或有批准处置；约束已验证；旧路径使用量达到删除门槛；端到端业务结果通过；每个阶段收据绑定同一 release。这样 Vibe Coding 仍可以生成迁移和样板代码，但发布顺序由可观察的不变量决定，而不是由 PR 中文件出现的顺序决定。

延伸阅读

• Vibe Coding Expand-Contract 数据库迁移
• Schema Registry 消费者兼容发布
• Agent API 契约兼容门
• 数据 Backfill 代际切换
• 数据库迁移管理