Flask-Migrate仅检测唯一约束而非完整模型的问题求助

启动应用时数据库已创建，但执行migrate时仅能检测到主键字段的唯一约束，无法识别新增的表：

INFO  [alembic.autogenerate.compare] Detected added unique constraint 'None' on '['Auth_ID']'
INFO  [alembic.autogenerate.compare] Detected added unique constraint 'None' on '['ClosedCourse_ID']'

核心模型定义 #

class SKAuthentication(db.Model):
    __tablename__ = 'sk-authentication'

    Auth_ID = db.Column(UUID(as_uuid=True), primary_key=True, unique=True)
    Basic_Auth = db.Column(Text, nullable=False)
    Basic_User = db.Column(Text, nullable=False)
    Teacher_ID = db.Column(UUID(as_uuid=True), db.ForeignKey('sk-teacher.Teacher_ID'), nullable=False)
    Model = db.Column(Text, nullable=True)
    Phone_ID = db.Column(Text, nullable=True)
    Brand = db.Column(Text, nullable=True)
    VersionInstalled = db.Column(Text, nullable=False, default='0.0.0')

    def __init__(self, teacher_id):
        chars = string.digits + string.ascii_letters + string.punctuation
        self.Basic_Password = ''.join(secrets.choice(chars) for _ in range(256))
        self.Auth_ID = create_ID(teacher_id, token_1, auth_crypt)
        self.Basic_Auth = sha512_crypt.encrypt(self.Basic_Password)
        self.Basic_User = create_ID(self.Basic_Auth, self.Auth_Secret)
        self.Teacher_ID = teacher_id


class SKDayilyClosedCourse(db.Model):
    __tablename__ = 'sk-daily-closed-course'

    ClosedCourse_ID = db.Column(UUID(as_uuid=True), primary_key=True, unique=True)
    Teachers_Group_ID = db.Column(UUID(as_uuid=True), db.ForeignKey('sk-teachers-groups.Row_ID'), nullable=False)
    Course_Date = db.Column(Date, nullable=False)
    Closed = db.Column(BOOLEAN, nullable=False, default=False)
    Reminded = db.Column(BOOLEAN, nullable=False, default=False)

    def __init__(self, teachers_group_id, course_date, reminded):
        self.ClosedCourse_ID = create_ID(teachers_group_id, False, False, course_date)
        self.Teachers_Group_ID = teachers_group_id
        self.Course_Date = course_date
        self.Reminded = reminded

相关配置代码 #

run.py #

from flask import Flask, session
from flask_sqlalchemy import SQLAlchemy
from modules.extensions import csrf, migr, cors
from config import DevelopmentConfig
from flask_migrate import upgrade, migrate
from datetime import timedelta

db = SQLAlchemy()
migr = Migrate()

def create_app():
    app = Flask(__name__)
    csrf.init_app(app)
    app.config.from_object(DevelopmentConfig)
    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
    db.init_app(app)
    cors.init_app(app, resources={r"/mobile/v1/*": {"origins": "GET, POST, OPTIONS"}})
    migr.init_app(app, db, render_as_batch=False)

    with app.app_context():
        import modules.database.model
        db.create_all()
        db.session.commit()
        migrate()
        upgrade()

        from application import application
        from application import application_ticket
        from application import application_mobile
        from application import application_bookings

        app.register_blueprint(application.application)
        app.register_blueprint(application_ticket.ticket, url_prefix="/ticket")
        app.register_blueprint(application_mobile.mobile, url_prefix="/mobile/v1")
        app.register_blueprint(application_bookings.bookings, url_prefix="/bookings/v1")

       
    @app.before_request
    def before_request():
        session.permanent = True
        app.permanent_session_lifetime = timedelta(minutes=1)

    return app

extensions.py #

from flask_wtf import CSRFProtect
from flask_migrate import Migrate
from flask_cors import CORS

csrf = CSRFProtect()
migr = Migrate()
cors = CORS()
# 其他扩展定义...

wsgi.py #

from run import create_app

app = create_app()

已尝试的无效方案 #

• 在models.py中手动触发表创建
• 确认模型已被正确导入
• 通过控制台直接执行flask db migrate命令
• 删除alembic_version表后重新执行迁移

期望输出 #

希望执行migrate时能正确检测到新增表，输出类似：

INFO  [alembic.autogenerate.compare] Detected added table '[<Tablename>]'
...

问题排查与解决方案 #

1. 移除db.create_all()的干扰 #

在create_app的上下文初始化中，先调用db.create_all()会直接在数据库中创建所有模型对应的表，导致Alembic后续执行migrate时，因为表已存在无法检测到"新增表"的变化。

解决： 注释或删除db.create_all()和db.session.commit()，让Alembic完全接管表的创建和迁移流程：

# with app.app_context():
#     import modules.database.model
#     # 移除以下两行
#     # db.create_all()
#     # db.session.commit()
#     migrate()
#     upgrade()

2. 修复主键冗余的unique=True设置 #

主键字段默认已具备唯一约束，额外添加unique=True会导致Alembic误识别为新增约束（名称显示None是因为PostgreSQL自动生成的约束名无法被Alembic正确捕获）。

解决： 移除主键字段上的unique=True：

# 原代码
Auth_ID = db.Column(UUID(as_uuid=True), primary_key=True, unique=True)
# 修改后
Auth_ID = db.Column(UUID(as_uuid=True), primary_key=True)

# 原代码
ClosedCourse_ID = db.Column(UUID(as_uuid=True), primary_key=True, unique=True)
# 修改后
ClosedCourse_ID = db.Column(UUID(as_uuid=True), primary_key=True)

3. 统一使用命令行执行迁移流程 #

不要在create_app中直接调用migrate()和upgrade()，避免每次启动应用都执行迁移造成状态混乱，改用命令行工具：

1. 在项目根目录创建.flaskenv文件：

FLASK_APP=wsgi.py
FLASK_ENV=development

2. 初始化迁移（首次执行）：

flask db init

3. 生成迁移脚本：

flask db migrate -m "add sk-authentication and sk-daily-closed-course tables"

4. 应用迁移：

flask db upgrade

4. 检查版本兼容性与模型导入 #

• 更新到稳定版本确保兼容：

pip install --upgrade flask-migrate alembic

• 确认modules.database.model中所有需要迁移的模型都被正确导入，无遗漏或循环导入问题。

5. 重置迁移状态（最后手段） #

若上述方法无效，彻底重置迁移状态：

1. 删除项目中的migrations文件夹
2. 删除数据库中的alembic_version表
3. 重新初始化迁移：

flask db init
flask db migrate -m "initial migration"
flask db upgrade

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