部署在Cloud Run的Flask REST API遇SQLAlchemyAutoSchema AttributeError错误求助

错误原因 #

这个AttributeError: columns错误的核心原因是：UserSchema的dump_only列表中包含了confirmation，但confirmation是UserModel中的SQLAlchemy关系（relationship）属性，而非数据库列。

当marshmallow-sqlalchemy的SQLAlchemyAutoSchema自动生成字段时，会尝试将dump_only中的所有属性当作数据库列处理，但关系属性没有columns属性，因此触发报错。

另外，从Python3.7升级到Python3.10后，依赖包（尤其是marshmallow-sqlalchemy）的版本自动更新到了更严格的版本，旧版本可能允许这种不规范写法，新版本则直接抛出错误。

解决方法 #

方法1：显式定义confirmation字段（推荐） #

既然confirmation是关系属性，需要用marshmallow的Nested字段显式声明，而非依赖自动生成：

修改schemas/user.py：

from marshmallow import pre_dump, fields
from ma import ma
from models.user import UserModel
from schemas.confirmation import ConfirmationSchema  # 导入对应关系的Schema

class UserSchema(ma.SQLAlchemyAutoSchema):
    # 显式声明confirmation为嵌套字段
    confirmation = fields.Nested(ConfirmationSchema, many=True)

    class Meta:
        model = UserModel
        load_instance = True
        load_only = ("password",)
        dump_only = ("id",)  # 移除confirmation，因为已显式定义

    @pre_dump
    def _pre_dump(self, user: UserModel, **kwargs):
        user.confirmation = [user.most_recent_confirmation]
        return user

方法2：移除dump_only中的confirmation（若无需序列化该字段） #

如果API不需要返回confirmation相关数据，直接从dump_only中移除即可：

修改schemas/user.py的Meta类：

class Meta:
    model = UserModel
    load_instance = True
    load_only = ("password",)
    dump_only = ("id",)  # 去掉confirmation项

方法3：锁定兼容的依赖版本 #

若希望保留原有写法，可以锁定marshmallow-sqlalchemy到Python3.7环境下的兼容版本（比如0.24.2，需根据旧环境实际版本调整），在requirements.txt中添加：

marshmallow-sqlalchemy==0.24.2

额外注意事项 #

• 方法1中需确保ConfirmationSchema已正确定义，否则Nested字段会报错。
• 清理requirements.txt中的重复依赖（比如Flask-SQLAlchemy出现两次），避免版本冲突。

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