如何在SQLAlchemy中定义仅内存非持久化列（适配Marshmallow场景）

嘿，这个场景我太熟悉了！刚好可以结合SQLAlchemy和Marshmallow的特性完美解决，下面是具体的实现步骤：

1. 在SQLAlchemy模型中定义内存专属字段 #

要创建一个只在内存中存在、不对应数据库列的字段，最简单的方式就是直接在模型类里声明普通的实例属性——不要用db.Column()装饰它，这样SQLAlchemy会完全忽略这个属性，不会尝试把它持久化到数据库。

如果需要给这个字段加一些逻辑（比如自定义的getter/setter），可以用SQLAlchemy的@hybrid_property装饰器，同样不要关联任何数据库列：

from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import Column, Integer, String

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    
    id = Column(Integer, primary_key=True)
    username = Column(String(50), unique=True)
    
    # 普通内存字段：直接赋值，不会被持久化
    temp_calc_value = None
    
    # 带逻辑的内存字段：用hybrid_property实现
    @hybrid_property
    def full_name(self):
        # 基于临时属性做内存计算
        return f"{self._first_name} {self._last_name}" if hasattr(self, '_first_name') else ""
    
    @full_name.setter
    def full_name(self, value):
        # 拆分JSON传入的全名到临时属性
        self._first_name, self._last_name = value.split(" ", 1)

2. 用Marshmallow映射JSON中的额外字段 #

Marshmallow完全支持映射模型的非数据库属性，你只需要在Schema里定义对应的字段，它就会在加载JSON时自动赋值到模型的内存属性，导出时也可以选择是否包含该字段：

from marshmallow import Schema, fields, post_load

class UserSchema(Schema):
    id = fields.Integer(dump_only=True)
    username = fields.String(required=True)
    # 对应模型的普通内存字段
    temp_calc_value = fields.Float()
    # 对应模型的hybrid_property字段
    full_name = fields.String()
    
    @post_load
    def make_user(self, data, **kwargs):
        return User(**data)

# 使用示例：从JSON加载到模型实例
json_payload = {
    "username": "johndoe",
    "temp_calc_value": 99.9,
    "full_name": "John Doe"
}

schema = UserSchema()
user = schema.load(json_payload)

# 验证内存字段的存在
print(user.temp_calc_value)  # 输出: 99.9
print(user.full_name)        # 输出: John Doe

# 保存到数据库时，SQLAlchemy只会处理id和username列
# db.session.add(user)
# db.session.commit()

关键注意点 #

• 绝对不要给内存字段加db.Column()，否则SQLAlchemy会强制在数据库中创建对应列。
• 使用@hybrid_property时，确保不要关联任何数据库表达式（比如column_property），保持逻辑完全在内存中。
• Marshmallow的post_load方法会自动把JSON字段映射到模型属性，不管这个属性是否对应数据库列，非常灵活。

这样就能完美实现你的需求：JSON里的额外字段被加载到模型的内存属性中用于计算，保存模型时只有数据库列会被持久化。

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