Django4.0+Postgres13更新基表时物化视图迁移报错问题

PostgreSQL 原生限制不允许直接修改被物化视图依赖的基表字段类型。即使为物化视图对应的模型设置了managed=False，Django 迁移框架也不会自动感知物化视图与基表的依赖关系，不会在执行基表结构变更前自动处理物化视图的重建逻辑，因此触发数据库层面的拦截报错。
额外的迁移设计问题：managed=False的模型不应该出现在初始迁移的CreateModel操作列表中，这是首次执行makemigrations时模型未配置managed=False，或生成迁移后未清理冗余操作导致的，会让Django错误追踪本不该由它管理的视图结构。

1. 修正初始迁移冗余 #

编辑0001_initial.py，直接删除CustomerDetailView对应的CreateModel代码块。该物化视图完全通过手写RunSQL创建维护，Django不需要为其生成任何建表/结构变更逻辑，从根源避免迁移框架对非托管模型的错误处理。

2. 重构字段变更迁移 #

所有涉及修改被物化视图依赖的基表字段的迁移，必须严格遵循**「删除依赖物化视图 → 执行基表结构变更 → 重建物化视图及关联索引」**的流程，同时保证正向、反向迁移逻辑完全可逆。
针对当前报错的0003_alter_customer_external_id.py，修改为如下内容：

class Migration(migrations.Migration):
    dependencies = [
        ('customers', '0002_customer_detail_view'),
    ]

    operations = [
        # 正向第一步：删除依赖目标字段的物化视图；反向操作：重建旧版本物化视图
        migrations.RunSQL(
            "DROP MATERIALIZED VIEW IF EXISTS customer_detail_view;",
            """
            CREATE MATERIALIZED VIEW customer_detail_view AS
            SELECT
                cus.id,
                cus.external_id
            FROM customer cus;
            CREATE UNIQUE INDEX customer_detail_view_pk ON customer_detail_view(external_id);
            """
        ),
        # 执行原有的基表字段修改逻辑
        migrations.AlterField(
            model_name='customer',
            name='external_id',
            field=models.CharField(blank=True, max_length=60, null=True, unique=True),
        ),
        # 正向第三步：用新字段结构重建物化视图；反向操作：删除新版本物化视图
        migrations.RunSQL(
            """
            CREATE MATERIALIZED VIEW customer_detail_view AS
            SELECT
                cus.id,
                cus.external_id
            FROM customer cus;
            CREATE UNIQUE INDEX customer_detail_view_pk ON customer_detail_view(external_id);
            """,
            "DROP MATERIALIZED VIEW IF EXISTS customer_detail_view;"
        )
    ]

3. 长期维护规范 #

• 所有物化视图的创建、更新、删除操作全部通过显式RunSQL实现，每次执行makemigrations后必须检查生成的迁移文件，若出现针对managed=False视图模型的结构操作，直接删除并手动补充对应SQL逻辑。
• 可将物化视图的创建、删除SQL抽为模块级常量，在多个迁移中复用，避免手写SQL出现字段映射不一致的问题。
• 生产环境执行迁移前，必须在预发布环境验证迁移可逆性：执行升级迁移后，回滚到上一个迁移版本，确认回滚流程无报错、数据结构一致。

禁止通过修改PostgreSQL约束配置、临时禁用规则的方式绕过依赖检查，这类操作会导致物化视图与基表结构不一致，引发后续查询报错、数据不一致的严重问题。

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