SQLAlchemy 2.x无法正确解析ORM对象：查询返回元组而非预期的Manga实例

嘿，我看你遇到了SQLAlchemy 2.x异步查询返回元组而非ORM实例的问题，我来帮你捋捋原因和解决办法：

问题根源 #

你提到使用session.execute/session.scalar/session.scalars时返回的是元组，甚至scalar只拿到id，核心原因可能是你没有正确提取ORM实例：

• 当用session.execute执行select(Manga)时，返回的Result对象里的每一行是一个包含Manga实例的元组（比如(Manga(...),)），直接遍历的话会得到这个元组，而不是实例本身；
• session.scalar方法会取结果集中第一行的第一个标量值，如果行是(Manga(...),)，它会返回Manga实例，但如果你的查询被意外解析为Core查询（而非ORM查询），就会返回元组的第一个元素——也就是manga_id。

解决办法 #

1. 用session.scalars()获取ORM实例

修改你的查询方法，使用session.scalars()替代session.scalar或直接遍历execute结果，它会直接返回ORM实例的集合：

async def get_by_title(session: AsyncSession, title: str) -> Optional[Manga]:
    query = select(Manga).where(Manga.title == title).limit(1)
    # 使用scalars()获取ScalarResult对象，再调用first()拿第一个实例
    result = await session.scalars(query)
    return result.first()

同样，打印行的方法也可以改成直接遍历ORM实例：

async def print_rows(session: AsyncSession, title: str):
    query = select(Manga).where(Manga.title == title)
    result = await session.scalars(query)
    for manga in result:
       # 现在可以直接访问实例属性，比如manga.title、manga.manga_id
       print(f"ID: {manga.manga_id}, Title: {manga.title}")

2. 检查Session创建是否正确

确保你的异步Session是通过async_sessionmaker正确绑定异步引擎的：

from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
from sqlalchemy.orm import sessionmaker

# 创建异步引擎（注意用sqlite+aiosqlite:///协议）
engine = create_async_engine("sqlite+aiosqlite:///your_database.db")
# 创建异步Session工厂
async_session = sessionmaker(
    engine,
    class_=AsyncSession,
    expire_on_commit=False  # 可选，避免提交后实例过期
)

# 使用Session的方式
async with async_session() as session:
    manga = await get_by_title(session, "你的漫画标题")

3. 确保表结构与ORM定义一致

确认你的数据库表是通过ORM的Base.metadata.create_all创建的，避免手动建表导致字段不匹配：

async with engine.begin() as conn:
    # 同步执行metadata创建表操作
    await conn.run_sync(Base.metadata.create_all)

4. 检查select的导入是否正确

确保你导入的是SQLAlchemy 2.x的统一select方法：

from sqlalchemy import select  # 正确，同时支持Core和ORM查询

额外说明 #

如果之前直接遍历session.execute的结果得到元组，那其实是Row对象的表现形式——你可以通过row[0]来取出里面的Manga实例，比如：

result = await session.execute(query)
for row in result:
    manga = row[0]  # 取出Manga实例
    print(manga.title)

备注：内容来源于stack exchange，提问作者Chase R Lewis