Alembic自动生成迁移文件异常：误将表识别为列

从你提供的迁移脚本和模型代码来看，问题核心集中在模型与现有数据库表不匹配、模型定义错误以及Alembic配置缺失三个方面，以下是具体修复步骤：

一、修正模型中的关键错误 #

1. 修复DateCreation的default_factory写法 #

你当前的default_factory直接调用了datetime.utcnow().date，这会在类定义时就生成固定日期值，而非每次创建对象时生成新日期，同时这不是合法的可调用对象，会导致SQLModel解析异常：

class DateCreation(SQLModel):
    # 用lambda延迟执行，确保每次创建对象时生成新日期
    date_creation: datetime = Field(
        default_factory=lambda: datetime.utcnow().date(), nullable=False
    )
    # 若需存储完整datetime而非日期，替换为：
    # date_creation: datetime = Field(default_factory=datetime.utcnow, nullable=False)

2. 匹配模型表名与数据库现有表名 #

迁移脚本显示旧表名为personskill、offerskill，但你的模型类Person_skill、Offer_skill默认生成的表名是person_skill、offer_skill（下划线分隔），这导致Alembic误判为需要删除旧表并创建新表。若要保留现有表，需在模型中指定__tablename__：

class Person_skill(ORM, table=True):
    __tablename__ = "personskill"  # 对齐数据库旧表名
    __table_args__ = {"extend_existing": True}
    # ... 其余字段不变

class Offer_skill(ORM, DateCreation, table=True):
    __tablename__ = "offerskill"  # 对齐数据库旧表名
    __table_args__ = {"extend_existing": True}
    # ... 其余字段不变

3. 对齐主键字段与数据库结构 #

现有数据库表使用id作为主键，但你的模型改用了id_offer、id_project等自定义主键名，这导致Alembic错误生成"删除旧主键、添加新主键"的操作。若希望保留现有主键列，需将模型主键改回id：

class Offer(ORM, DateCreation, table=True):
    __table_args__ = {"extend_existing": True}
    id: Optional[int] = Field(primary_key=True)  # 与数据库主键名对齐
    # ... 其余字段不变

若确实需要修改主键名，需手动编写迁移脚本（主键修改风险较高，建议先备份数据）。

二、检查Alembic的env.py配置 #

确保env.py中正确导入所有表模型，并将target_metadata设置为SQLModel的元数据，否则Alembic无法识别全部模型：

# env.py核心配置代码
from sqlmodel import SQLModel
# 导入你所有的表模型
from your_module import Offer, Skill, Project, Person, Person_skill, Offer_skill

target_metadata = SQLModel.metadata

def run_migrations_offline():
    # ... 其余代码不变
    context.configure(
        url=url,
        target_metadata=target_metadata,
        literal_binds=True,
        dialect_opts={"paramstyle": "named"},
    )
    # ...

def run_migrations_online():
    # ... 其余代码不变
    with connectable.connect() as connection:
        context.configure(
            connection=connection,
            target_metadata=target_metadata
        )
    # ...

三、重新生成迁移脚本 #

1. 备份数据库，避免数据丢失
2. 删除之前生成的错误迁移文件
3. 执行命令重新生成迁移：

alembic revision --autogenerate -m "fix table matching and model errors"

4. 仔细检查新生成的迁移脚本，确认所有操作符合预期后，执行迁移：

alembic upgrade head

额外注意事项 #

• 确保ORM类正确继承自SQLModel，否则模型元数据无法被Alembic识别：

class ORM(SQLModel):
    # 你的update、delete等方法

• 若数据库中已有数据，禁止直接执行自动生成的迁移脚本，必须手动校验调整删除/重命名关键列的操作。

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