SQLAlchemy Declarative Base与SQLModel共用时外键识别问题问询

• 你当前使用的SQLAlchemy原生declarative_base生成的Base，和SQLModel自带的SQLModel.metadata是两个完全独立的元数据容器，互相不感知对方管理的表结构。当你在SQLModel模型中声明外键关联老Base下的表时，SQLModel的元数据找不到对应表，就会触发外键关联错误。

推荐使用共享元数据的方案，不需要修改任何存量SQLAlchemy模型代码，对现有业务无侵入：

1. 在定义所有SQLModel模型前，将你现有Base的元数据赋值给SQLModel.metadata，让两类模型共用同一份元数据容器
2. 后续无需分别调用两次create_all，任意调用其中一个的create_all方法即可，会自动按依赖顺序创建所有表

修改后的代码示例：

from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import Column, Integer, String
from typing import Optional
from sqlmodel import Field, SQLModel

# 原有声明逻辑不变
Base = declarative_base()

# 新增：让SQLModel复用现有Base的元数据
SQLModel.metadata = Base.metadata

class DummySATable(Base):
    __tablename__ = 'dummy_table'
    id = Column(Integer, primary_key=True, autoincrement=True)
    name = Column(String(32))


class DummyModelTable(SQLModel, table=True):
    id: Optional[int] = Field(default=None, primary_key=True)
    dummy_table_id : int = Field(default=None, foreign_key='dummy_table.id')
    name: str

# 只需要调用一次create_all即可
Base.metadata.create_all(engine)
# 不需要再调用SQLModel.metadata.create_all(engine)

如果因为特殊场景不能共享元数据，也可以采用以下方式临时解决：

• 声明外键时直接关联原有模型类的字段，而非字符串形式的表名：dummy_table_id : int = Field(default=None, foreign_key=DummySATable.id)
• 严格保证创建表顺序，先调用Base.metadata.create_all(engine)创建所有存量表，再调用SQLModel.metadata.create_all(engine)创建新表

该方案在SQLModel 0.0.x和SQLAlchemy 1.4/2.x版本下均测试可用，无需修改存量业务逻辑，可实现平滑过渡试用SQLModel。

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