SQLAlchemy多表关联场景下如何高效存储多张媒体图片

你当前的设计不管是存储效率还是扩展性都有明显缺陷，核心问题如下：

• 直接用LargeBinary把图片二进制内容存在数据库中，会让数据库体积快速膨胀，拖慢常规查询、备份、数据迁移的速度，尤其是查询房源列表这类不需要返回图片的场景，很容易出现不必要的性能损耗
• Media表固定写死media1/media2/media3三个字段扩展性极差：遇到需要上传4张及以上图片的房源就必须改表结构，图片不足3张时还会空占存储空间
• 关系配置存在冲突：你在PropertyContains里定义了名为media的关系，又在relationship里设置backref="media"，两边同名很容易出现取值报错、循环引用的问题；另外主键字段本身自带唯一约束，额外加unique=True属于多余配置，字段名大小写混用（比如Location大写开头）也不符合Python常规命名规范，后期维护容易出问题。

行业内通用的高效做法是数据库只存图片的元信息，实际图片文件存在文件系统中，对新手来说实现门槛很低，性能比存数据库好很多：

1. 重构表结构 #

废弃固定列存图片的设计，改成一条Media记录对应一张图片，实现一个房源配套关联任意数量图片的灵活结构，去掉数据库存二进制的逻辑，只存文件相关的属性信息，参考代码如下：

class Property(Base):
    __tablename__ = "property"
    property_id = Column(Integer, primary_key=True, index=True)
    user_id = Column(Integer, ForeignKey("propertyOwner.user_id"))
    title = Column(String)
    description = Column(String)
    location = Column(String) # 统一小写字段名，符合命名规范
    rented = Column(Boolean)
    rented_by = Column(Integer, ForeignKey("client.client_id"))
    date = Column(Date, default=func.now())

    contains = relationship("PropertyContains", back_populates="contains_owner")
    owner = relationship("Owner", back_populates="properties")


class PropertyContains(Base):
    __tablename__ = "propertyContains"
    property_contains_id = Column(Integer, primary_key=True, index=True)
    property_id = Column(Integer, ForeignKey("property.property_id"))
    bed_rooms = Column(Integer)

    contains_owner = relationship("Property", back_populates="contains")
    # 一对多关联媒体资源，命名避免冲突
    media_list = relationship("Media", back_populates="belong_to_contain", passive_deletes=True)


class Media(Base):
    __tablename__ = "media"
    media_id = Column(Integer, primary_key=True, index=True)
    contain_id = Column(Integer, ForeignKey('propertyContains.property_contains_id', ondelete="CASCADE"))
    # 仅存储文件元信息，不存二进制内容
    file_path = Column(String, nullable=False) # 图片的存储访问路径
    original_name = Column(String) # 图片原始文件名
    file_type = Column(String) # 图片格式，比如jpg、png
    upload_time = Column(Date, default=func.now())
    # 反向关联配置
    belong_to_contain = relationship("PropertyContains", back_populates="media_list")

2. 调整文件存储逻辑 #

上传图片时不需要把文件内容读入数据库，按以下流程处理即可：

• 收到前端上传的图片后，生成一个不会重复的文件名（比如用UUID拼接原文件后缀，避免重名覆盖）
• 把图片文件存到项目专门存放静态资源的目录，比如项目根目录下的/static/property_images/路径
• 在Media表插入一条对应记录，把刚才的文件存储路径、文件名等信息存入即可
• 前端需要展示图片时，直接从Media表读取文件路径，拼上静态资源的访问前缀就能直接加载，不需要经过数据库读取二进制流再转码，响应速度提升非常明显。

等你后期项目规模变大，需要更高的文件访问性能时，只需要把本地存储的图片迁移到专门的存储服务，数据库层的代码完全不需要改动，扩展性很强。

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