使用Alembic初始迁移时创建带外键表遇NoReferencedTableError错误

核心错误：重复定义DeclarativeBase #

你在airport.py和country.py中各自独立定义了Base(DeclarativeBase)，这导致每个模型的元数据（metadata）分属不同的Base实例。当Alembic处理Airport模型的外键时，它的metadata里没有Country表的定义，因此找不到country.id，触发NoReferencedTableError。

另外注意country.py里的字段拼写错误：currencty应该改为currency，避免后续数据库操作出现异常。

修复步骤 #

1. 统一Base类定义 #

创建单独的base.py文件，在其中定义唯一的Base类，所有模型都继承这个Base：

# base.py
from sqlalchemy.orm import DeclarativeBase

class Base(DeclarativeBase):
    pass

2. 修改模型文件，导入统一Base #

更新airport.py：

# airport.py
from sqlalchemy import String, ForeignKey
from sqlalchemy.orm import Mapped, mapped_column, relationship
from typing import List
from .base import Base

class Airport(Base):
    __tablename__ = 'airport'

    id: Mapped[int] = mapped_column(primary_key=True)
    name: Mapped[str] = mapped_column(String(50))
    iata_short: Mapped[str] = mapped_column(String(5))
    icao_short: Mapped[str] = mapped_column(String(5))
    timezone: Mapped[str] = mapped_column(String(5))

    country_id: Mapped[int] = mapped_column(ForeignKey('country.id'))
    country: Mapped['Country'] = relationship(back_populates='airports')

    departure_reservations: Mapped[List["Reservation"]] = relationship(back_populates='departure_airport')
    arrival_reservations: Mapped[List["Reservation"]] = relationship(back_populates='arrival_airport')

更新country.py：

# country.py
from sqlalchemy import String
from sqlalchemy.orm import Mapped, mapped_column, relationship
from typing import List
from .base import Base

class Country(Base):
    __tablename__ = 'country'

    id: Mapped[int] = mapped_column(primary_key=True)
    name: Mapped[str] = mapped_column(String(20))
    continent: Mapped[str] = mapped_column(String(20))
    currency: Mapped[str] = mapped_column(String(3))  # 修正拼写错误

    airports: Mapped[List['Airport']] = relationship(back_populates='country')

3. 调整env.py的target_metadata #

现在所有模型都归属同一个Base的metadata，env.py只需导入这个统一的metadata即可：

# env.py
from models.base import Base
# 导入所有模型确保元数据加载完整
from models import (
    aircraft_type, 
    airline,
    airport,
    country,
    reservation,
    tariff,
    user
)

target_metadata = Base.metadata

4. 关于Alembic创建迁移时连接数据库的说明 #

Alembic的autogenerate功能需要连接数据库，对比当前数据库状态与模型定义的差异来生成迁移文件，这是该功能的正常行为。如果要避免创建迁移时连接数据库，只能禁用autogenerate，手动编写迁移文件，但会失去自动生成的便利性，通常不建议这么做。

验证修复 #

删除之前生成的错误迁移文件（若存在），重新执行迁移命令：

alembic revision --autogenerate -m "initial tables"
alembic upgrade head

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