Flask-SQLAlchemy ORM与JSON序列化：排查“User对象无法JSON序列化”错误
在Flask框架结合SQLAlchemy ORM进行数据库操作时，经常会遇到对象序列化问题。本文将详细分析并解决常见的“TypeError: Object of type 'User' is not JSON serializable”错误。
问题描述：
使用SQLAlchemy定义的User模型类，尝试通过User.query.all()获取所有用户数据，并直接将其序列化为JSON时，发生序列化错误。
示例代码：
from sqlalchemy import Column, Integer, String
from lib.database import Base # 假设lib.database包含数据库连接配置
class User(Base):
__tablename__ = 'users' # 表名
id = Column(Integer, primary_key=True)
app_key = Column(String(50), unique=True)
secret = Column(String(120), unique=True)
def __init__(self, app_key=None, secret=None):
self.app_key = app_key
self.secret = secret
def __repr__(self):
return f'<User {self.app_key}>'
# ... 查询代码 ...
users = User.query.all()
# ... 此处报错 ...
错误原因分析：
jsonify函数无法直接序列化SQLAlchemy的ORM对象（User实例）。ORM对象包含数据库相关属性和方法，这些并非JSON可识别的标准数据类型。
解决方案：
需要自定义方法将User对象转换为JSON可序列化的字典。
修改User类：
class User(Base):
# ... (原有代码) ...
def to_dict(self):
return {
"id": self.id,
"app_key": self.app_key,
"secret": self.secret,
}
修改Flask路由函数：
from flask import jsonify
@app.route("/users")
def get_users():
users = User.query.all()
return jsonify([user.to_dict() for user in users])
通过to_dict方法将每个User对象转换为字典，再用jsonify序列化为JSON响应，即可解决序列化错误。 这确保了数据以正确的JSON格式返回给前端。
