Marshmallow-SQLAlchemy：如何从映射数据库表的模型自动加载所有字段到Schema？

问题详情 #

我定义了如下Schema：

class Users(SQLAlchemyAutoSchema):
    class Meta:
        model = models.Users
        include_fk = True
        include_relationships = True

对应的Model直接绑定数据库表：

class Users(db.Model):
    __table__ = db.Model.metadata.tables['dbo.Users']

打印模型时能看到所有列，但打印Schema却得到空字典。想实现无需手动设置就能加载所有字段，尝试用fields = '__all__'时触发错误：ValueError: fields option must be a list or tuple.

另外看到Marshmallow-SQLAlchemy官方文档这段内容，但不太理解：

模型中任何并非直接派生自Column的column_property（例如映射表达式）都会被检测并标记为dump_only。Hybrid_property则完全不会被自动处理，需要显式声明为字段。

原因分析 #

你的Users模型是通过__table__直接绑定现有数据库表的，这种方式下Marshmallow-SQLAlchemy的自动字段检测机制无法识别表中的列——它默认只处理用db.Column显式定义的模型属性，而非通过__table__映射的隐式列。

解决方法 #

方法1：自动生成字段（无需修改模型） #

如果不想手动列所有字段，可以遍历模型的表列，用auto_field自动添加到Schema中：

from marshmallow_sqlalchemy import SQLAlchemySchema, auto_field

class Users(SQLAlchemySchema):
    class Meta:
        model = models.Users
        include_fk = True
        include_relationships = True

# 遍历表的所有列，为Schema自动添加对应字段
for column in models.Users.__table__.columns:
    setattr(Users, column.name, auto_field(column.name))

方法2：改用显式列定义的模型（推荐） #

如果可以修改模型定义，改成declarative_base风格的显式列声明，SQLAlchemyAutoSchema就能自动识别所有字段：

# 替换原模型定义
class Users(db.Model):
    __tablename__ = 'dbo.Users'
    # 显式声明所有数据库列，示例：
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(50))
    # ... 其他列按实际表结构补充

这样原有的SQLAlchemyAutoSchema就能正常加载所有字段，不需要额外配置。

关于fields='__all__'的问题 #

Marshmallow-SQLAlchemy的SQLAlchemyAutoSchema不支持fields='__all__'参数，它要求fields必须是列表或元组，所以要么手动列出所有字段名，要么用上面的自动生成方法。

官方文档内容解释 #

那段文档的意思是：

• 若模型用column_property定义了派生属性（比如通过SQL表达式计算出的虚拟字段，不是数据库表中实际存在的列），自动Schema会将这些属性标记为dump_only——只能用于序列化输出，不能用于反序列化输入。
• 若用hybrid_property定义的混合属性（结合Python逻辑和SQL的属性），自动Schema完全不会处理，必须手动在Schema里声明对应的字段才能使用。

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