使用SqlAlchemy生成迁移时遇NameError: 'models'未定义错误

错误根源 #

1. 导入路径错误：env.py和models.py在同一migrations目录下，用import migrations.models会导致命名空间混乱，直接引用models会找不到。
2. Model类未继承Base：models.py里的User类既没定义SQLAlchemy的Base类，也没继承它，导致models.Base完全不存在。

修复步骤 #

1. 修正models.py代码 #

先定义SQLAlchemy的Base基类，让User类继承它：

from sqlalchemy import Column, BigInteger, Text
from sqlalchemy.ext.declarative import declarative_base

# 定义Base基类
Base = declarative_base()

class User(Base):
    __tablename__ = 'user'

    id = Column(BigInteger, primary_key=True)
    discord_id = Column(Text)
    server_id = Column(Text)
    name = Column(Text)

2. 调整env.py的导入逻辑 #

因为两个文件在同一目录，用相对导入或者直接导入即可：

# 相对导入方式（推荐）
from .models import Base

target_metadata = Base.metadata

# 或者直接导入（如果相对导入报错）
import models

target_metadata = models.Base.metadata

3. 重新执行迁移命令 #

回到dir目录下，重新运行：

alembic revision --autogenerate -m 'adds user table'

额外提醒 #

• 确认已经安装sqlalchemy和alembic依赖
• 检查alembic.ini里的sqlalchemy.url是否正确配置了你的数据库连接地址

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