Alembic级联删除失败与升级降级函数顺序异常求助

问题1：删除termin表时因外键依赖报错 #

• 核心问题：你在relationship里设置的cascade是ORM层面的级联规则，而数据库层面的外键约束需要在ForeignKey字段上配置ondelete="CASCADE"，否则PostgreSQL会阻止删除被其他表依赖的主表。
• 解决步骤：
  1. 修改zavrseniTermin和sportistaTermin模型的外键字段，添加数据库级别的级联删除规则：

     # 示例：zavrseniTermin模型中的外键定义
     termin_id = Column(Integer, ForeignKey("termin.id", ondelete="CASCADE"), nullable=False)
     

  2. 重新生成迁移文件：执行alembic revision --autogenerate -m "add ondelete cascade for termin foreign keys"
  3. 检查迁移文件的删表顺序，如果Alembic自动生成的是先删termin再删依赖表，手动调整upgrade函数的顺序——必须先删zavrseniTermin和sportistaTermin，再删termin：

     def upgrade() -> None:
         op.drop_table('zavrseniTermin')
         op.drop_table('sportistaTermin')
         op.drop_table('termin')
     

  4. 执行alembic upgrade head完成迁移

问题2：Alembic迁移文件的upgrade/downgrade操作颠倒 #

• 核心原因：Alembic的自动迁移是基于当前模型与数据库历史版本的差异生成的：
  • 如果当前模型比历史版本少了表，upgrade会执行删表（把数据库同步到当前模型状态），downgrade执行建表（回退到之前的状态）
  • 你觉得“颠倒”，大概率是模型变更方向和你的预期不符，或者迁移基准配置有问题
• 解决步骤：
  1. 确认当前模型定义：如果预期是“升级建表”，说明你应该是要新增表，但当前模型里可能误删了表定义，先恢复正确的模型结构
  2. 检查Alembic元数据配置：确保alembic/env.py中的target_metadata正确指向你的SQLAlchemy Base类的metadata：

     from your_app.models import Base
     target_metadata = Base.metadata
     

  3. 若之前的迁移是误生成的，删除错误的迁移文件，重新执行alembic revision --autogenerate -m "create required tables"，此时生成的upgrade会是建表，downgrade是删表
  4. 若确实需要删除表（当前模型就是要移除termin表），那当前的迁移逻辑是正确的——Alembic的upgrade是让数据库追上当前模型，downgrade是回退到之前的状态，无需修改

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