如何在Flask-SQLAlchemy中关联父子表并单次查询返回全量数据

问题原因 #

子表address的state、zip_code字段未返回，核心原因是序列化器（推测是Marshmallow Schema）未包含这些字段。你的SQLAlchemy关联配置是正确的，数据库中对应字段的数据也存在，只是序列化过程中被过滤了。

解决方案 #

1. 定义完整的Marshmallow Schema #

你代码中用到的user_data是Marshmallow Schema实例，需要补充子表的所有字段定义：

from marshmallow import Schema, fields

# 子表address的Schema，包含所有需要返回的字段
class AddressSchema(Schema):
    idaddress = fields.Integer()
    city = fields.String()
    state = fields.String()
    zip_code = fields.String()
    img_id = fields.Integer()

# 父表img_details的Schema，关联子表Schema
class ImgDetailsSchema(Schema):
    id = fields.Integer()
    img_url = fields.String()
    description = fields.String()
    short_description = fields.String()
    address = fields.Nested(AddressSchema, many=True)  # many=True对应一对多关联

# 创建Schema实例
user_data = ImgDetailsSchema()

2. 修正视图函数的序列化调用 #

查询结果是多条记录的列表，调用dump时需指定many=True：

@bp.route('/user_data', methods=["GET"])
def get_user_data():
    all_list = img_details.query.join(address).all()
    result = user_data.dump(all_list, many=True)
    return jsonify({'submitted_records': result})

3. 可选优化：避免N+1查询 #

虽然用了join，但SQLAlchemy默认可能延迟加载关联数据，可通过joinedload直接加载关联表，提升查询性能：

from sqlalchemy.orm import joinedload

@bp.route('/user_data', methods=["GET"])
def get_user_data():
    all_list = img_details.query.options(joinedload(img_details.address)).all()
    result = user_data.dump(all_list, many=True)
    return jsonify({'submitted_records': result})

额外建议：模型命名规范 #

按照Python和SQLAlchemy惯例，模型类名建议用驼峰式（如ImgDetails、Address），替代小写下划线命名，提升代码可读性。

验证结果 #

修改后返回的JSON会包含address的所有字段：

{
    "submitted_records": [
        {
            "address": [
                {
                    "city": "tet",
                    "idaddress": 123,
                    "state": "XXX",
                    "zip_code": "12345",
                    "img_id": 50
                }
            ],
            "description": "Application Development full Stack",
            "id": 50,
            "img_url": "http://127.0.0.1:5000//uploads/profilepic1.jpg",
            "short_description": "Software Application engineer"
        }
    ]
}

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