SQLModel删除用户触发ForeignKeyViolationError，关联组未同步删除如何修复？

问题出在数据库外键约束未配置级联删除，虽然你在ORM的Relationship中设置了cascade，但这只是ORM层面的级联规则，而数据库本身的外键约束没有同步配置删除时的级联动作，导致删除用户时数据库因外键引用报错。

直接修改Group模型中user_id字段的外键配置，添加ON DELETE CASCADE：

import uuid
from typing import Optional
from sqlmodel import SQLModel, Field, Relationship

class User(SQLModel, table=True):
    id: str = Field(primary_key=True, nullable=False)
    group: Optional["Group"] = Relationship(
        sa_relationship_kwargs={"uselist": False, "cascade": "save-update,merge,expunge,delete,delete-orphan"},
        back_populates="user")

class Group(SQLModel, table=True):
    group_id: uuid.UUID = Field(default_factory=uuid.uuid4, primary_key=True, index=True, nullable=False)
    # 在外键定义中添加 ON DELETE CASCADE
    user_id: Optional[str] = Field(default=None, foreign_key="user.id ON DELETE CASCADE", nullable=True)
    user: Optional["User"] = Relationship(back_populates="group")

为什么这样有效？ #

• 添加ON DELETE CASCADE后，数据库层面会自动处理关联删除：当你删除user表中的一条记录时，数据库会自动删除group表中所有user_id匹配的记录，从根源避免外键约束冲突。
• 你原有的ORM级联配置可以保留，它会在ORM层面处理对象的关联状态同步，而数据库级联则作为兜底保证数据一致性。

如果已经生成了数据库表结构，需要执行迁移脚本更新外键约束（比如用Alembic），否则修改不会生效。

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