使用SeparateDatabaseAndState移除Django非空字段的问题咨询

背景与初始尝试 #

我的Django模型定义如下：

class Product(models.Model):
    name = models.CharField(max_length=128)
    is_retired = models.BooleanField(default=False)

我需要移除is_retired字段，由于生产环境采用蓝绿部署策略，所以使用SeparateDatabaseAndState操作做迁移——只修改Django的应用状态，暂时不改动数据库结构：

class Migration(migrations.Migration):
    dependencies = ...
    operations = [
        migrations.SeparateDatabaseAndState(
            state_operations=[
                migrations.RemoveField(
                    model_name="product",
                    name="is_retired",
                ),
            ],
            database_operations=[],
        ),
    ]

迁移执行成功，但执行Product.objects.create(name="Wrench")创建新产品时，触发了数据库完整性错误：

self = <django.db.backends.sqlite3.base.SQLiteCursorWrapper object at 0x106bf4050>
query = 'INSERT INTO "core_product" ("name") VALUES (?) RETURNING "core_product"."id"'
params = ('Wrench',)

    def execute(self, query, params=None):
        if params is None:
            return super().execute(query)
        # Extract names if params is a mapping, i.e. "pyformat" style is used.
        param_names = list(params) if isinstance(params, Mapping) else None
        query = self.convert_query(query, param_names=param_names)
>       return super().execute(query, params)
E       django.db.utils.IntegrityError: NOT NULL constraint failed: core_product.is_retired

原因很明确：数据库中is_retired字段仍存在且带有非空约束，但Django ORM已经不再在INSERT语句中包含该字段，导致数据库无法获取非空值，触发约束错误。

我的解决方案 #

我调整了迁移步骤，先将数据库中的is_retired字段改为可空，再修改应用状态移除该字段：

class Migration(migrations.Migration):
    dependencies = ...
    operations = [
        migrations.AlterField(
            model_name="product",
            name="is_retired",
            field=models.BooleanField(default=False, null=True),
        ),
        migrations.SeparateDatabaseAndState(
            state_operations=[
                migrations.RemoveField(
                    model_name="product",
                    name="is_retired",
                ),
            ],
            database_operations=[],
        ),
    ]

调整后，Product.objects.create(name="Wrench")可以正常执行。

我的疑问 #

1. 这是修复该错误的最佳方式吗？还有其他思路吗？我曾尝试将is_retired的默认值改回False，但未能成功。
2. 在蓝绿部署期间将字段从非空改为可空是否安全？我认为是安全的，但想确认一下。

问题1解答 #

你的修复方式是蓝绿部署场景下的合理方案，除此之外还有两种可选思路：

• 分步兼容迁移：
  1. 第一步：保留模型中的is_retired字段，但业务代码中不再使用它，确保所有创建/更新Product的逻辑都能正确设置该字段值（依赖默认值或显式赋值均可）。
  2. 第二步：将这个兼容版本部署到蓝绿环境，验证新旧版本都能正常运行。
  3. 第三步：执行仅移除应用状态的迁移，等流量完全切换到新版本后，再单独执行删除数据库字段的迁移。
• 补设数据库字段默认值：
  如果数据库中的is_retired字段没有正确设置默认值（虽然模型定义了default=False，但迁移历史可能有偏差），可以在SeparateDatabaseAndState的database_operations中添加设置默认值的操作，比如针对SQLite执行ALTER TABLE core_product ALTER COLUMN is_retired SET DEFAULT 0，针对PostgreSQL则是ALTER TABLE core_product ALTER COLUMN is_retired SET DEFAULT FALSE。补设默认值后，即使INSERT语句不包含该字段，数据库会自动填充默认值，不会触发非空约束错误。

你尝试改默认值没成功，大概率是只修改了模型但没生成对应的数据库迁移操作，或者没有在database_operations中同步更新数据库层面的默认值设置。

问题2解答 #

蓝绿部署期间将字段从非空改为可空是完全安全的：

• 旧环境（绿环境）的代码仍然会给is_retired字段赋值False（依赖默认值或显式设置），数据库允许空值但旧代码不会产生空值，所以旧版本的业务逻辑不受任何影响。
• 新环境（蓝环境）的代码不再处理该字段，数据库允许空值后，会自动使用已有的默认值False填充，不会出现空值，自然不会触发约束错误。
• 流量切换过程中，无论请求路由到哪个环境，数据写入都能正常完成，不会出现兼容性问题。

内容的提问来源于stack exchange，提问作者Johnny Metz