pre-migration-data-verification

在向已有数据的表添加约束（如 CREATE UNIQUE INDEX、ALTER ... ADD CHECK、ALTER ... NOT NULL、ADD FOREIGN KEY）之前，务必先查询现有数据中可能违反约束的记录，并在同一迁移块中编写清理语句（UPDATE/DELETE），然后再创建约束。跳过此步骤将导致迁移静默失败（“重复键” / “检查约束违规” / “不允许空值”），整个迁移回滚，且错误直到下次部署时才会暴露。适用于以下场景的表述：“向已有表添加唯一约束”、“CREATE UNIQUE INDEX 迁移”、“ALTER TABLE ADD CHECK”、“对已有数据设置列 NOT NULL”、“向已填充数据的表添加外键”、“迁移静默失败”。不适用于首次创建表的迁移（无现有数据可违反约束）、仅添加列但无约束的迁移（默认值可处理空缺）或可清空的数据库环境。以 PostgreSQL 为主，该模式同样适用于 MySQL/SQLite/Oracle。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本