SQLAlchemy关联与association_proxy问题：静态表关联插入报错

问题核心 #

你当前的代码在创建A对象时，若传入新建的Type实例（如Type(id="2",name="Two")），SQLAlchemy会将该实例识别为**游离状态（transient）**的对象，在提交事务时尝试向只读的Type表插入数据，触发唯一约束错误。

解决方案 #

1. 优先通过type_ids关联（最便捷） #

你已经定义了type_ids关联代理，直接传入已存在的Type id列表即可，无需手动创建Type实例，SQLAlchemy会自动完成关联映射：

# 直接用type_ids关联，无需查询Type对象
new_a = A(id="SomeId", type_ids=["2"])
session.add(new_a)
session.commit()

2. 关联已加载的Type实例 #

如果需要使用Type对象关联，必须从数据库中获取已存在的实例，而非新建：

# 从数据库读取已存在的Type对象
target_type = session.get(Type, "2")
# 创建A对象并关联
new_a = A(id="SomeId", types=[target_type])
session.add(new_a)
session.commit()

3. 配置关系禁止自动保存关联对象（可选强化） #

在A的types关系中添加save_update=False，禁止SQLAlchemy自动保存关联的Type对象，避免误插入：

class A(Base):
    __tablename__ = "a"
    id: Mapped[str] = mapped_column(unique=True, index=True, primary_key=True)
    types: Mapped[List["Type"]] = relationship(
        lazy="selectin", 
        secondary=a_to_type_mapping,
        save_update=False  # 不自动保存关联的Type对象
    )
    type_ids: AssociationProxy[List[str]] = association_proxy("types","id")

4. 给Type模型添加只读防护（可选） #

在Type模型中配置__mapper_args__，禁止初始化时自动保存对象，进一步强化只读特性：

class Type(Base):
    __tablename__ = "type"
    id: Mapped[str] = mapped_column(index=True, primary_key=True, unique=True)
    name: Mapped[str] = mapped_column(unique=True, nullable=False)
    __mapper_args__ = {"save_on_init": False}  # 初始化实例时不自动保存到数据库

最佳实践 #

• 日常关联优先使用type_ids，代码更简洁且避免不必要的对象实例化。
• 若必须使用Type对象，务必通过session.get()或session.query()从数据库获取，确保对象处于持久化状态。
• 结合save_update=False和__mapper_args__的配置，从模型层面杜绝向Type表插入数据的可能。

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