on_delete='CASCADE' 失效咨询：多对多关联模型场景

阿华AIGC实验室

2026-5-19

嘿，我之前在用手动中间表实现多对多关联时，也碰到过on_delete='CASCADE'不生效的坑！咱们一步步来排查和解决这个问题：

1. 先确认数据库是否开启了外键支持

很多数据库默认是关闭外键约束的（比如SQLite），这会导致即使你在ORM里配置了CASCADE，数据库层面根本不会执行级联删除。以SQLite为例，你需要在初始化数据库时手动开启外键：

# 比如用Peewee的话，连接后执行这条SQL
db.execute_sql('PRAGMA foreign_keys = ON;')

其他数据库比如PostgreSQL、MySQL默认是开启的，但也可以通过数据库命令确认外键约束是否启用。

2. 检查中间表的模型定义是否正确

确保你的UserRoleThrough中间表的ForeignKeyField确实正确传递了on_delete='CASCADE'参数，并且关联的是正确的模型。举个正确的示例（以Peewee为例）：

class UserRoleThrough(BaseModel):
    user = ForeignKeyField(User, on_delete='CASCADE', backref='roles')
    role = ForeignKeyField(Role, on_delete='CASCADE', backref='users')

    class Meta:
        primary_key = CompositeKey('user', 'role')  # 多对多中间表通常用联合主键

注意：如果你用的是其他ORM（比如SQLAlchemy），参数名或写法可能略有不同，但核心是要把级联删除的规则绑定到外键上。

3. 验证数据库表结构是否生成了正确的外键约束

有时候ORM在创建表时，可能因为配置问题没有生成带ON DELETE CASCADE的外键约束。你可以通过数据库的命令来查看表的外键信息：

SQLite：执行PRAGMA foreign_key_list(UserRoleThrough);，查看输出中的on_delete字段是否为CASCADE
PostgreSQL：执行SELECT conname, confdeltype FROM pg_constraint WHERE conrelid = 'userrolethrough'::regclass;，confdeltype为c代表CASCADE
MySQL：执行SHOW CREATE TABLE UserRoleThrough;，查看外键定义中的ON DELETE CASCADE是否存在

如果这里没有看到CASCADE的配置，那说明表创建时没有应用你的ORM配置，可能需要重新生成表（或者手动添加外键约束）。

4. 测试删除操作的正确性

执行删除操作时，尽量用ORM提供的删除方法（比如User.get_by_id(1).delete_instance()），而不是直接执行原生SQL（虽然数据库层面的约束应该不管执行方式都生效，但ORM的方法可以确保上下文正确）。删除后直接查看UserRoleThrough表的记录，确认关联数据是否被自动删除。