如何通过SQLAlchemy命令式数据类映射获取ORM对象而非Row对象？

你遇到的问题核心是没有完成完整的ORM映射注册，直接查询了数据库表（核心层）而非映射后的ORM类，所以返回的是LegacyRow而非User实例。完全可以直接操作模型实例，只要调整映射和查询方式即可，下面是具体步骤：

1. 确保完成ORM映射注册 #

命令式数据类映射需要显式把数据类和数据库表关联起来，而不是只分别定义两者。示例代码如下：

from sqlalchemy import create_engine, Table, Column, Integer, String, MetaData
from sqlalchemy.orm import sessionmaker, registry
from dataclasses import dataclass

# 初始化元数据和映射注册器
metadata = MetaData()
mapper_registry = registry(metadata=metadata)

# 定义带init=False的id字段的数据类
@dataclass
class User:
    id: int = None
    name: str
    email: str

# 定义数据库表结构
user_table = Table(
    "user",
    metadata,
    Column("id", Integer, primary_key=True, autoincrement=True),
    Column("name", String(50)),
    Column("email", String(100))
)

# 关键：将数据类与表做ORM映射
mapper_registry.map_imperatively(User, user_table)

2. 使用ORM方式查询 #

查询时要针对User类（ORM层）而非user_table（核心层），这样就能返回User实例：

# 创建引擎和会话
engine = create_engine("sqlite:///test.db")
metadata.create_all(engine)
Session = sessionmaker(bind=engine)
session = Session()

# 插入数据（id会自动赋值，无需传入）
new_user = User(name="Bob", email="bob@example.com")
session.add(new_user)
session.commit()
print(new_user.id)  # 这里会输出数据库生成的id

# 正确的ORM查询方式
# 方式1：session.query
user = session.query(User).filter_by(name="Bob").first()
print(type(user))  # <class '__main__.User'>
print(user.email)

# 方式2：ORM版select
from sqlalchemy.orm import select
stmt = select(User).where(User.email == "bob@example.com")
user = session.execute(stmt).scalar()
print(type(user))  # <class '__main__.User'>

关于id字段init=False的说明 #

因为id是自增主键，初始化时不需要传入值，ORM映射完成后，当你把实例添加到会话并提交，SQLAlchemy会自动将数据库生成的id赋值给实例的id属性，完全不需要额外写构造器方法。

总结 #

只要完成正确的ORM映射注册，你完全可以像操作普通ORM模型实例一样，对User进行增删改查操作，所有属性都会和数据库字段正确绑定。

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