使用Flask+SQLAlchemy修改表unique约束且不丢失数据的方法

SQLAlchemy 本身不会自动同步模型修改到已创建的表结构，但可以通过以下两种 SQLAlchemy 生态内的原生方案实现需求，全程无需删除已有数据，支持 Python 命令行操作：

方案1：直接通过 SQLAlchemy 核心API执行DDL修改 #

适合不想引入额外依赖的场景，直接在 Flask 命令行执行即可：

1. 进入 Flask 交互shell：

flask shell

2. 先查询当前表的唯一约束名（不同数据库的约束命名规则略有差异）：

from your_app import db, Books # 替换your_app为你自己的Flask应用入口模块名

inspector = db.inspect(db.engine)
unique_constraints = inspector.get_unique_constraints('books')
print(unique_constraints)

输出会返回所有唯一约束的名称和对应列，比如name列对应的约束名可能是books_name_key（PostgreSQL）、books_name_unique（MySQL）。
3. 执行删除唯一约束操作：

with db.engine.connect() as conn:
    # 替换下方约束名为你上一步查询到的实际名称
    # PostgreSQL 写法
    conn.execute(db.text("ALTER TABLE books DROP CONSTRAINT IF EXISTS books_name_key"))
    conn.execute(db.text("ALTER TABLE books DROP CONSTRAINT IF EXISTS books_author_key"))
    # MySQL 写法（如果上面的语句报错则用这个）
    # conn.execute(db.text("ALTER TABLE books DROP INDEX IF EXISTS books_name_unique"))
    # conn.execute(db.text("ALTER TABLE books DROP INDEX IF EXISTS books_author_unique"))
    conn.commit()

操作完成后再把你的模型代码里的unique=True删掉即可，后续调用db.create_all()也不会产生冲突。

方案2：通过Flask-Migrate（Alembic）实现自动迁移 #

这是Flask+SQLAlchemy技术栈修改表结构的标准方案，后续所有表结构变更都可以复用这套流程，不需要手动写SQL：

1. 安装依赖：

pip install flask-migrate

2. 在你的Flask应用入口文件中初始化迁移工具：

from flask_migrate import Migrate

# app是你已经创建的Flask实例，db是你已经创建的SQLAlchemy实例
migrate = Migrate(app, db)

3. 第一次使用时执行初始化迁移仓库（仅需执行一次）：

flask db init

4. 把模型代码里的unique=True删除后，执行命令自动生成迁移脚本：

flask db migrate -m "移除name和author字段的唯一约束"

5. 检查生成的迁移脚本（存放在项目migrations/versions目录下），确认操作是删除两个唯一约束，没有删表、删列的风险操作。
6. 执行迁移到数据库：

flask db upgrade

操作完成后表结构会自动更新，数据完全保留。

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