如何在SQLAlchemy中配置多对多关系并避免对只读表执行级联操作

我来帮你搞定这个头疼的问题！核心原因是SQLAlchemy默认会把你从REST请求中拿到的未被Session管理的Funcionalidade对象当成全新的临时对象，所以会尝试插入到只读表中。要实现你的需求（只存Setor和中间关联表，不碰dominios.dm_funcionalidade），我们需要从两个方面调整配置和对象处理方式：

1. 正确配置多对多关联的参数 #

首先修改Setor类的funcionalidades关联，明确告诉SQLAlchemy不要对关联的Funcionalidade对象执行持久化操作，但允许管理中间表的关联：

class Setor(db.Model):
    __tablename__ = "setores"
    id = Column(Integer, primary_key=True, autoincrement=True)
    uuid = Column(String(36), unique=True, nullable=False, default=uuid4)
    nome = Column(String(50), nullable=False, unique=True)
    funcionalidades = relationship(
        "Funcionalidade",
        secondary=map_setores_funcionalidades,
        lazy="select",
        cascade="merge",  # 只允许merge操作，避免自动插入关联对象
        passive_deletes=True,
        passive_updates=True,
        # 可选：明确关联条件，避免SQLAlchemy自动猜测可能出问题
        primaryjoin="Setor.id == map_setores_funcionalidades.c.id_setor",
        secondaryjoin="Funcionalidade.id == map_setores_funcionalidades.c.id_funcionalidade"
    )

这里的关键参数作用：

• cascade="merge"：只允许SQLAlchemy将关联对象合并到Session中，不会触发插入/更新操作
• passive_deletes=True/passive_updates=True：完全禁用对Funcionalidade表的级联操作，依赖数据库外键约束（如果有的话）

2. 把关联的Funcionalidade标记为已存在的对象 #

从REST请求拿到功能ID后，不要直接创建全新的临时对象，而是把它们标记为**脱管（detached）**状态——告诉SQLAlchemy这些对象已经在数据库里了，不需要插入：

方法一（兼容SQLAlchemy 1.4+） #

# 假设从REST请求获取的功能ID列表是rest_func_ids
funcionalidades = []
for func_id in rest_func_ids:
    # 只创建带主键的Funcionalidade对象
    func = Funcionalidade(id=func_id)
    # 先加入Session再移除，标记为脱管状态
    db.session.add(func)
    db.session.expunge(func)
    funcionalidades.append(func)

# 创建并保存新的Setor
novo_setor = Setor(nome="Novo Setor", funcionalidades=funcionalidades)
db.session.add(novo_setor)
db.session.commit()

方法二（SQLAlchemy 2.0+ 更简洁） #

from sqlalchemy import orm

funcionalidades = []
for func_id in rest_func_ids:
    func = Funcionalidade(id=func_id)
    orm.detach(func)  # 直接标记为脱管状态
    funcionalidades.append(func)

novo_setor = Setor(nome="Novo Setor", funcionalidades=funcionalidades)
db.session.add(novo_setor)
db.session.commit()

为什么这样能解决问题？ #

• 脱管状态的对象：SQLAlchemy会认为这些对象已经存在于数据库中，不会尝试插入
• cascade="merge"：保存Setor时，SQLAlchemy只会处理中间表的关联插入，不会碰Funcionalidade表
• 完全避免了查询数据库的额外开销，不需要先从数据库加载Funcionalidade对象

这样配置后，你就能实现：持久化Setor、插入中间表关联、完全不操作只读的dominios.dm_funcionalidade表的需求啦！

内容的提问来源于stack exchange，提问作者Igor R. Braga