原生SQLAlchemy拆分模型到多文件创建关联关系报错问询

核心错误原因 #

你在frame_model.py和sale_model.py中分别实例化了两个完全独立的declarative_base()对象，两个基类的元数据存储空间互相隔离，SaleModel对应的base实例无法感知到另一个base下注册的inventory表，因此触发外键关联失败的报错。同时你的代码还存在公共组件重复定义、表创建逻辑分散、字段与关联关系重名的额外问题。

具体修复步骤 #

• 第一步：抽离公共基础组件
  在models文件夹下新建base.py，统一存放公共的基类和自定义类型，避免重复定义：

from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.dialects.postgresql import TSVECTOR
from sqlalchemy.types import TypeDecorator

class TSVector(TypeDecorator):
    impl = TSVECTOR
    cache_ok = True

base = declarative_base()

• 第二步：改造两个模型文件，统一继承公共基类
  1. 删掉两个模型文件中各自的TSVector定义、base = declarative_base()声明，以及末尾的base.metadata.create_all(db_engine)调用
  2. 两个模型文件头部都新增导入：from .base import base, TSVector，所有模型类继承这个公共的base
  3. 修正SaleModel中的重名问题：你的表字段已经有一个frame字段，不能再定义同名的relationship，修改关联声明：

     # FrameModel 中修改为
     sale = relationship("SaleModel", back_populates="frame_info")
     
     # SaleModel 中修改为
     frame_info = relationship("FrameModel", back_populates="sale")
     

• 第三步：统一执行表创建逻辑
  在项目入口文件或者你的db_connector.py中，确保所有模型类都被导入后，统一调用一次表创建方法即可：

# 先导入所有模型，让base的元数据注册所有表信息
from models.frame_model import FrameModel
from models.sale_model import SaleModel
from models.base import base
from .db_connector import db_engine

# 统一创建表
base.metadata.create_all(db_engine)

处理后所有表都注册在同一个base的元数据中，外键关联即可正常识别。

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