Flask SQLAlchemy一对多关联查询Event对象无法JSON序列化问题求助

报错原因 #

UserSchema中仅声明了需要序列化events字段，但未指定关联字段的序列化规则，Marshmallow会直接返回原生Event ORM对象，JSON无法识别该类对象就会抛出类型错误。

修复步骤 #

1. 调整Schema定义，在UserSchema中嵌套EventSchema处理关联的事件列表：

# 注意EventSchema必须定义在UserSchema之前，否则嵌套时会找不到定义
class EventSchema(ma.Schema):
    class Meta:
        fields = ('id', 'name', 'description', 'address',
                  'date', 'time', 'lat', 'lng', 'user_id')


class UserSchema(ma.Schema):
    # 嵌套事件序列化规则，一对多关系需配置many=True
    events = ma.Nested(EventSchema, many=True)
    class Meta:
        # 建议移除password字段，避免敏感信息泄露
        fields = ('id', 'username', 'email', 'admin', 'events')


user_schema = UserSchema()
users_schema = UserSchema(many=True)
event_schema = EventSchema()
events_schema = EventSchema(many=True)

2. 可选优化：查询用户时加入关联预加载，避免N+1查询性能问题：

@app.route('/users', methods=['GET'])
def get_all_users():
    # joinedload会一次性关联查询用户对应的所有事件，减少数据库查询次数
    all_users = User.query.options(db.joinedload(User.events)).order_by(User.username).all()
    result = users_schema.dump(all_users)
    return jsonify({'Users': result})

修改完成后调用/users接口即可正常返回带关联事件列表的用户数据。

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