SQLAlchemy 2.0中SAWarning问题求助：关联子对象触发警告

这并非旧问题的重复，该SAWarning在SQLAlchemy 2.0中重现，且常规级联配置无法消除，是代码迁移至2.0时的阻塞点。以下是可复现问题的极简代码：

from typing import List
from sqlalchemy.orm import (sessionmaker, Mapped, mapped_column,
                            DeclarativeBase, relationship)
from sqlalchemy import Integer, create_engine, ForeignKey

class Base(DeclarativeBase):
    pass

class Foo(Base):
    __tablename__ = 'foo'
    id: Mapped[int] = mapped_column(primary_key=True)
    bars: Mapped[List["Bar"]] = relationship(back_populates="foo")

class Bar(Base):
    __tablename__ = 'bar'
    id: Mapped[int] = mapped_column(ForeignKey('foo.id'), primary_key=True)
    foo: Mapped["Foo"] = relationship(back_populates="bars")

engine = create_engine("sqlite://")
Session = sessionmaker(engine)

Base.metadata.create_all(engine)

db = Session()
foo = Foo()
db.add(foo)
bar = Bar()
# 以下代码会触发SAWarning
bar.foo = foo
# 以下代码不会触发警告
# foo.bars.append(bar)
db.commit()

问题原因 #

SQLAlchemy 2.0中，当将已添加到会话但未提交/刷新的父对象（如示例中的foo）赋值给子对象的关系属性时，ORM无法立即获取父对象的主键值（自增主键未生成），因此触发关于未保存关联的SAWarning。而通过集合添加关联的方式，ORM会自动处理待保存状态的关联逻辑，不会触发该警告。

解决方法 #

1. 提前刷新父对象获取主键

在赋值关系前，执行flush()让数据库生成父对象的主键，再建立关联：

foo = Foo()
db.add(foo)
db.flush()  # 刷新会话，获取foo的主键ID
bar = Bar()
bar.foo = foo
db.commit()

2. 显式配置关系的级联规则

在子对象的关系中显式声明cascade="save-update"（默认已包含，但显式声明可明确处理待保存关联）：

class Bar(Base):
    __tablename__ = 'bar'
    id: Mapped[int] = mapped_column(ForeignKey('foo.id'), primary_key=True)
    foo: Mapped["Foo"] = relationship(back_populates="bars", cascade="save-update")

3. 屏蔽特定警告

若确认业务逻辑无问题，可通过warnings模块屏蔽该SAWarning：

import warnings
from sqlalchemy import exc as sa_exc

warnings.filterwarnings("ignore", category=sa_exc.SAWarning)

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