SQLAlchemy操作Oracle如何实现级联删除 解决ORA-02292错误

问题根因 #

报错(cx_Oracle.IntegrityError) ORA-02292由两层配置不匹配导致：

• 数据库层面的外键约束未开启级联删除：你查询到的现有外键sys_c00310238的options字段为空，说明模型中ForeignKey配置的ondelete='CASCADE'没有同步到数据库。该参数仅在SQLAlchemy首次执行create_all()建表时生效，不会自动修改已存在的表约束。
• ORM配置冲突：passive_deletes=True参数会告知SQLAlchemy不要在ORM层加载关联子记录、主动发送子表删除语句，完全将级联逻辑交给数据库外键处理。数据库没有配置级联规则时，直接删除主表记录就会触发完整性校验报错。

可选修复方案 #

根据你是否有数据库表结构修改权限，二选一即可：

方案1：数据库层级联删除（性能优先，推荐） #

该方案删除主表记录时由数据库自动处理关联子记录，不需要ORM额外加载数据，适合关联数据量大的场景。

1. 先在Oracle中执行SQL，替换旧的无级别规则的外键：

-- 删除原有外键约束
ALTER TABLE crm_post_attachments DROP CONSTRAINT sys_c00310238;
-- 创建带级联删除规则的新外键
ALTER TABLE crm_post_attachments ADD CONSTRAINT fk_post_attachments_post_id 
FOREIGN KEY (post_id) REFERENCES crm_post(id) ON DELETE CASCADE;

2. 模型保留passive_deletes=True配置即可，修正后的代码：

class Post(Base):
    __tablename__ = "crm_post"

    id = Column(Integer, primary_key=True, index=True)
    title = Column(String(255), nullable=False)
    text = Column(String)
    img = Column(LargeBinary)
    author_id = Column(Integer, ForeignKey("crm_user.id"), nullable=False)
    sdate = Column(DateTime)
    edate = Column(DateTime)
    post_type = Column(Integer, ForeignKey("crm_dir_post_types.id"), nullable=False)
    attachments = relationship("PostAttachments", back_populates="post", passive_deletes=True, cascade='all, delete-orphan')


class PostAttachments(Base):
    __tablename__ = "crm_post_attachments"

    id = Column(Integer, primary_key=True, index=True)
    attachment = Column(LargeBinary)
    post_id = Column(Integer, ForeignKey("crm_post.id", ondelete='CASCADE'), nullable=False)
    post = relationship("Post", back_populates="attachments")

方案2：纯ORM层级联删除（无需修改库表结构） #

如果没有数据库DDL权限，可以移除passive_deletes=True配置，让SQLAlchemy在删除主表记录前，先加载所有关联的附件记录、先删子表数据再删主表数据，绕开外键校验。
修正后的模型代码：

class Post(Base):
    __tablename__ = "crm_post"

    id = Column(Integer, primary_key=True, index=True)
    title = Column(String(255), nullable=False)
    text = Column(String)
    img = Column(LargeBinary)
    author_id = Column(Integer, ForeignKey("crm_user.id"), nullable=False)
    sdate = Column(DateTime)
    edate = Column(DateTime)
    post_type = Column(Integer, ForeignKey("crm_dir_post_types.id"), nullable=False)
    # 移除passive_deletes参数，由ORM主动处理级联
    attachments = relationship("PostAttachments", back_populates="post", cascade='all, delete-orphan')


class PostAttachments(Base):
    __tablename__ = "crm_post_attachments"

    id = Column(Integer, primary_key=True, index=True)
    attachment = Column(LargeBinary)
    post_id = Column(Integer, ForeignKey("crm_post.id"), nullable=False)
    # 子表关系同步移除passive_deletes参数
    post = relationship("Post", back_populates="attachments")

注意：该方案在关联附件数量较多时，会产生额外的查询语句，将所有关联记录加载到内存后再删除，性能弱于数据库层级联。

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