Rails+Postgres生产库字段迁移后的数据与结构同步问题

1. 先完成数据全量同步 #

生产环境contract表仍保留score字段，先编写独立SQL脚本完成数据迁移，确保weekly_record表拿到所有有效score数据。假设两表通过contract_id关联，示例脚本如下：

-- 全量同步数据，根据业务逻辑调整关联条件
UPDATE weekly_record wr
INNER JOIN contract c ON wr.contract_id = c.id
SET wr.score = c.score
WHERE wr.score IS NULL OR wr.score != c.score;

执行前必须备份生产库，且先在测试环境验证脚本逻辑；若涉及大表，建议分批执行避免锁表影响业务。

2. 严格验证数据一致性 #

同步完成后，执行校验SQL确认数据完全迁移，只有当以下两个查询结果均为0时，才能进行下一步：

-- 检查是否存在数据不一致的记录
SELECT COUNT(*)
FROM contract c
JOIN weekly_record wr ON c.id = wr.contract_id
WHERE c.score != wr.score;

-- 检查是否有contract记录未同步到weekly_record
SELECT COUNT(*)
FROM contract c
LEFT JOIN weekly_record wr ON c.id = wr.contract_id
WHERE wr.score IS NULL AND c.score IS NOT NULL;

3. 新增迁移文件删除旧字段 #

禁止修改已在生产环境执行过的旧迁移文件（会破坏迁移记录一致性），需新增独立迁移文件专门删除contract表的score字段。以Django为例，迁移文件示例：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('your_app', '上一个迁移文件的名称'),
    ]

    operations = [
        migrations.RemoveField(
            model_name='contract',
            name='score',
        ),
    ]

执行迁移前再次确认数据备份完成，执行后检查contract表的score字段已被移除。

4. 规范后续迁移操作 #

生产环境已执行的迁移文件绝对不能手动修改，所有表结构调整必须通过新增迁移文件实现，避免开发/测试/生产环境的迁移记录出现分歧。

排除其他选项的原因 #

• 直接删除旧字段：会丢失未同步的有效数据，风险极高。
• 保留旧字段：会造成表结构冗余，后续易出现数据不一致（如误写旧字段）。
• 强制执行修改后的旧迁移：会破坏迁移记录完整性，导致后续迁移流程失败。

内容的提问来源于stack exchange，提问作者Daniele Deltodesco