在Flask项目里，使用SQLAlchemy等ORM操作数据库后，查询出来的通常是模型类实例，并不能直接通过Flask的jsonify返回。Marshmallow提供了一套声明式的方案，能把ORM对象序列化为字典或字典列表，也能把前端传来的字典反序列化为模型数据。
安装与基础配置
先通过pip安装必要依赖，然后在Flask应用中初始化Marshmallow。
# 安装命令 # pip install flask flask_sqlalchemy marshmallow marshmallow-sqlalchemy from flask import Flask from flask_sqlalchemy import SQLAlchemy from marshmallow_sqlalchemy import SQLAlchemyAutoSchema from marshmallow import fields app = Flask(__name__) app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///test.db' db = SQLAlchemy(app) ma = Marshmallow(app)
定义ORM模型与Schema
假设有一个User模型，包含id、name和email字段。可以用SQLAlchemyAutoSchema自动根据模型生成Schema，也可以手写字段。
# 定义ORM模型
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(50))
email = db.Column(db.String(120))
# 定义对应的Schema
class UserSchema(ma.SQLAlchemyAutoSchema):
class Meta:
model = User
load_instance = True
# 创建单对象和列表使用的schema实例
user_schema = UserSchema()
users_schema = UserSchema(many=True)
序列化单个对象与字典列表
使用dump方法可将模型实例转为字典，设置many=True的schema能把查询结果转成字典列表。
@app.route('/users')
def get_users():
# 查询所有用户，得到ORM对象列表
user_list = User.query.all()
# 序列化为字典列表
result = users_schema.dump(user_list)
return {'users': result}
@app.route('/user/<int:uid>')
def get_user(uid):
user = User.query.get(uid)
# 序列化为单个字典
result = user_schema.dump(user)
return result
手动定义字段的Schema写法
如果不想暴露全部字段，可以不用自动Schema，而是明确声明需要的字段。
class UserSchemaManual(ma.Schema):
id = fields.Int()
name = fields.Str()
email = fields.Email()
class Meta:
fields = ('id', 'name', 'email')
schema_manual = UserSchemaManual(many=True)
data_list = schema_manual.dump(User.query.all())
常见注意点
- 如果模型有关联关系，可用fields.Nested嵌套其他Schema来序列化。
- dump只做序列化，load_instance控制反序列化是否生成模型对象。
- 对于密码等敏感字段，不要在Schema中声明，避免泄露。
通过Marshmallow，Flask接口可以干净地把ORM数据转成字典列表，减少手工拼装字典的代码量。
小结
在Flask中配合Marshmallow扩展，只需定义好模型对应的Schema，调用dump方法就能轻松把ORM模型转成字典或字典列表。这种方式结构清晰，也便于后续做字段校验和接口文档维护。
FlaskMarshmallowORM修改时间：2026-07-26 21:33:46