SQLAlchemy双向backref多对多删除报StaleDataError如何解决？

问题根因 #

你遇到的报错核心原因是双向多对多关系重复配置了两次独立的relationship+backref，导致SQLAlchemy会对同一条关联表记录触发两次删除操作，第一次删除完成后，第二次删除找不到匹配行就抛出了StaleDataError。你原来的代码里还存在backref命名错误的问题，Product的relationship给Category反向生成的属性名是categories，和Category自身的字段、业务语义都不匹配，进一步加剧了逻辑冲突。

可行解决方案 #

方案1：使用back_populates显式声明双向映射（更推荐，语义清晰不易出错）

把两边的relationship配置改为用back_populates互相关联，替代原来的backref，修改后的完整模型代码如下：

# 关联表要放在两个模型类之前定义
product_categories = Table('product_categories', Base.metadata,
    Column('products_id', Integer, ForeignKey('products.id')),
    Column('categories_id', Integer, ForeignKey('categories.id'))
)

class Product(Base):
    """ The SQLAlchemy declarative model class for a Product object. """
    __tablename__ = 'products'

    id = Column(Integer, primary_key=True)
    part_number = Column(String(10), nullable=False, unique=True)
    name = Column(String(80), nullable=False, unique=True)
    description = Column(String(2000), nullable=False)
    # back_populates指向Category类中对应的关联属性名
    categories = relationship('Category', secondary=product_categories,
                              back_populates='products')

class Category(Base):
    """ The SQLAlchemy declarative model class for a Category object. """                        
    __tablename__ = 'categories'                                                                 

    id = Column(Integer, primary_key=True)
    lft = Column(Integer, nullable=False)
    rgt = Column(Integer, nullable=False)                                                        
    name = Column(String(80), nullable=False)                                                    
    description = Column(String(2000), nullable=False)                                           
    order = Column(Integer)                                                                      
    # back_populates指向Product类中对应的关联属性名，原有的lazy、order_by配置保留
    products = relationship('Product', secondary=product_categories,
                            back_populates='categories',
                            lazy='dynamic',
                            order_by=name)

这种配置下，SQLAlchemy会识别两边的关联属于同一组多对多关系，删除操作只会触发一次关联表记录清理，不会出现重复删除的问题，同时完全保留你需要的双向访问能力：Product实例.categories可获取关联分类，Category实例.products可获取关联商品。

方案2：仅保留单侧relationship+backref配置

如果不需要显式声明两侧关系，只需要在其中一个模型里定义relationship+backref，删除另一侧的relationship定义即可，backref会自动为对面模型生成对应的关联属性：
示例代码（只在Product侧配置）：

product_categories = Table('product_categories', Base.metadata,
    Column('products_id', Integer, ForeignKey('products.id')),
    Column('categories_id', Integer, ForeignKey('categories.id'))
)

class Product(Base):
    """ The SQLAlchemy declarative model class for a Product object. """
    __tablename__ = 'products'

    id = Column(Integer, primary_key=True)
    part_number = Column(String(10), nullable=False, unique=True)
    name = Column(String(80), nullable=False, unique=True)
    description = Column(String(2000), nullable=False)
    # backref直接定义Category侧的products属性和对应的配置
    categories = relationship('Category', secondary=product_categories,
                              backref=backref('products', lazy='dynamic', order_by=name))

class Category(Base):
    """ The SQLAlchemy declarative model class for a Category object. """                        
    __tablename__ = 'categories'                                                                 

    id = Column(Integer, primary_key=True)
    lft = Column(Integer, nullable=False)
    rgt = Column(Integer, nullable=False)                                                        
    name = Column(String(80), nullable=False)                                                    
    description = Column(String(2000), nullable=False)                                           
    order = Column(Integer)
    # 不需要再单独定义products属性，backref会自动生成                                                                    

这种配置也可以解决重复删除的问题，功能和方案1完全一致。

补充说明 #

你之前尝试修改engine.dialect.supports_sane_rowcount的方案无效的原因是：该配置只是屏蔽SQLAlchemy的行计数校验，本质上你还是执行了两次无效的删除操作，即使屏蔽了报错也会留下逻辑隐患，不建议使用。

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