如何快速将SQLAlchemy对象转换为Python字典？附关联查询示例

嘿，这个需求我之前在项目里也频繁遇到过，针对你这种加载了多个关联的Student对象列表，这里有几种靠谱的方案可以快速转换：

1. 手动构造字典（简单场景首选） #

如果你的字段不多，或者只需要特定字段，直接手动构造是最直观可控的方式，还能灵活处理嵌套关联：

students = query.all()
student_dicts = []

for student in students:
    # 基础字段
    student_dict = {
        "student_id": student.id,
        "last_name": student.student_last_name,
        "first_name": student.student_first_name,
        "middle_name": student.student_middle_name
    }
    # 处理一对一关联（比如project、image）
    if student.project:
        student_dict["project"] = {"id": student.project.id, "name": student.project.name}
    # 处理一对多集合（比如attached_addresses）
    student_dict["attached_addresses"] = [
        {"id": addr.id, "street": addr.street, "city": addr.city} 
        for addr in student.attached_addresses
    ]
    # 其他关联同理处理
    student_dicts.append(student_dict)

这种方法的好处是完全自定义，不需要额外依赖，性能也不错。

2. 用SQLAlchemy内置的inspect()工具（通用官方方案） #

SQLAlchemy提供了inspect()函数来安全获取对象的持久化属性，避免拿到内部的私有状态（比如_sa_instance_state），还能自动处理关联关系，适合通用场景：

from sqlalchemy import inspect

def sa_obj_to_dict(obj):
    """递归将SQLAlchemy对象转换为字典"""
    insp = inspect(obj)
    result = {}
    
    # 提取模型的基础字段
    for col in insp.mapper.column_attrs:
        result[col.key] = getattr(obj, col.key)
    
    # 处理关联关系
    for rel in insp.mapper.relationships:
        related_obj = getattr(obj, rel.key)
        if related_obj is None:
            result[rel.key] = None
            continue
        # 集合类型（一对多/多对多）递归转换每个元素
        if rel.uselist:
            result[rel.key] = [sa_obj_to_dict(item) for item in related_obj]
        # 一对一关联直接转换
        else:
            result[rel.key] = sa_obj_to_dict(related_obj)
    
    return result

# 使用示例
students = query.all()
student_dicts = [sa_obj_to_dict(student) for student in students]

这个方法不需要关心模型的具体字段，不管你加了多少新字段或关联，都能自动适配，是官方推荐的通用转换方式。

3. 用第三方库marshmallow-sqlalchemy（复杂项目首选） #

如果你的项目经常需要做对象和字典/JSON的转换，或者有大量模型需要处理，marshmallow-sqlalchemy会非常省心——它能直接基于SQLAlchemy模型生成序列化器，支持嵌套、验证、自定义字段等功能：

首先安装依赖：

pip install marshmallow-sqlalchemy

然后定义序列化器：

from marshmallow_sqlalchemy import SQLAlchemyAutoSchema
from your_project.models import Student  # 替换成你的模型导入路径

class StudentSchema(SQLAlchemyAutoSchema):
    class Meta:
        model = Student
        include_relationships = True  # 自动包含关联对象
        load_instance = True  # 可选，支持从字典转回模型对象

# 处理列表的话，设置many=True
schema = StudentSchema(many=True)
students = query.all()
student_dicts = schema.dump(students)

这种方式适合大型项目，扩展性强，还能轻松处理日期格式化、字段重命名等需求。

小提示 #

• 如果你的模型包含datetime类型字段，转字典后会是Python的datetime对象，如果需要转成字符串格式，可以在转换时手动处理（比如用obj.created_at.isoformat()），或者在marshmallow里用fields.DateTime(format='iso')来配置。
• 你用joinedload/subqueryload预加载的关联对象，上面的方法都能正常处理，因为这些对象已经被加载到内存中了。

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