Django执行flush时报外键约束截断错误，如何修复并添加级联？

问题场景 #

使用如下models.py定义多对多关系，执行迁移后运行flush命令时触发外键约束错误，无法截断表：

models.py 代码 #

from django.db import models

class Foo(models.Model):
    bars = models.ManyToManyField(
        "Bar",
        blank=True
    )

class Bar(models.Model):
    foos = models.ManyToManyField(
        "Foo",
        blank=True,
        through="Foo_bars"
    )

对应的迁移文件 #

from django.db import migrations, models


class Migration(migrations.Migration):
    initial = True

    dependencies = []

    operations = [
        migrations.CreateModel(
            name="Bar",
            fields=[
                (
                    "id",
                    models.BigAutoField(
                        auto_created=True,
                        primary_key=True,
                        serialize=False,
                        verbose_name="ID",
                    ),
                ),
            ],
        ),
        migrations.CreateModel(
            name="Foo",
            fields=[
                (
                    "id",
                    models.BigAutoField(
                        auto_created=True,
                        primary_key=True,
                        serialize=False,
                        verbose_name="ID",
                    ),
                ),
                ("bars", models.ManyToManyField(blank=True, to="demo.bar")),
            ],
        ),
        migrations.AddField(
            model_name="bar",
            name="foos",
            field=models.ManyToManyField(blank=True, to="demo.foo"),
        ),
    ]

执行命令 #

python manage.py migrate && python manage.py flush --no-input --traceback

错误回溯信息 #

File "/opt/venv/lib/python3.13/site-packages/psycopg/cursor.py", line 97, in execute
    raise ex.with_traceback(None)
django.db.utils.NotSupportedError: cannot truncate a table referenced in a foreign key constraint
DETAIL:  Table "demo_bar_foos" references "demo_foo".
HINT:  Truncate table "demo_bar_foos" at the same time, or use TRUNCATE ... CASCADE.

问题原因 #

模型定义存在冗余多对多关系：Foo.bars和Bar.foos双向指向彼此，且Bar.foos指定了through表，但Django会自动为Foo.bars生成独立中间表，最终产生两个相互独立的多对多中间表，引发外键约束冲突，导致flush无法单独截断主表。

解决步骤 #

1. 修正模型定义（推荐方案） #

只保留一个多对多字段，通过related_name实现反向关联，避免重复定义。如需自定义中间表，统一在单个字段中指定：

from django.db import models

class Foo(models.Model):
    bars = models.ManyToManyField(
        "Bar",
        blank=True,
        related_name="foos",  # Bar实例可通过bar.foos访问关联的Foo
        through="FooBar"  # 自定义中间表（按需保留）
    )

class Bar(models.Model):
    # 无需重复定义foos字段，通过related_name实现反向访问
    pass

# 自定义中间表（若需额外字段则保留，否则Django自动生成）
class FooBar(models.Model):
    foo = models.ForeignKey(Foo, on_delete=models.CASCADE)
    bar = models.ForeignKey(Bar, on_delete=models.CASCADE)
    
    class Meta:
        db_table = "foo_bar"  # 可选：指定中间表名

2. 重新生成迁移 #

删除migrations目录下除__init__.py外的旧迁移文件，执行：

python manage.py makemigrations
python manage.py migrate

3. 临时兼容方案（不修改模型时） #

如果无法调整模型结构，可通过修改flush的SQL逻辑实现级联截断：

• 方法一：手动修改SQL并执行

python manage.py sqlflush | sed 's/TRUNCATE/TRUNCATE CASCADE/' | python manage.py dbshell

该命令会将sqlflush生成的语句替换为带CASCADE的截断命令，自动删除关联中间表数据。

• 方法二：自定义Flush命令
  在项目中创建management/commands/flush.py：

from django.core.management.commands.flush import Command as FlushCommand

class Command(FlushCommand):
    def get_flush_sql(self, using, tables, sequences, allow_cascade):
        sql = super().get_flush_sql(using, tables, sequences, allow_cascade)
        return [s.replace("TRUNCATE", "TRUNCATE CASCADE") if "TRUNCATE" in s else s for s in sql]

之后执行python manage.py flush --no-input即可自动应用级联截断。

关键说明 #

• 多对多关系只需在一个模型中定义，通过related_name实现反向访问，避免冗余中间表。
• 自定义中间表时，外键需添加on_delete=models.CASCADE，确保主表记录删除时自动清理关联数据。
• PostgreSQL的TRUNCATE命令默认不处理外键约束，必须显式添加CASCADE才能同时截断关联表。

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