如何阻止alembic revision --autogenerate在无模型变更时生成空版本文件

空迁移文件的作用 #

Alembic默认设计下，无论是否检测到模型变更都会生成迁移版本文件，这类空文件的常见适用场景包括：

• 手动写入非SQLAlchemy模型映射的数据库操作，比如批量修正历史数据、创建自定义约束、调整存储过程等
• 多分支协作开发时作为迁移分支合并的锚点，解决不同分支迁移版本的依赖冲突问题
• 标记特定数据库版本节点，方便后续做版本回滚、灰度发布的版本锚定

配置自动跳过空迁移生成 #

你可以通过配置实现和Django makemigrations一致的效果，无变更时直接输出提示不生成文件：

1. 先确保Alembic版本 >= 1.9.0，低版本可以先升级：

pip install --upgrade alembic

2. 在项目的alembic.ini配置文件中添加如下配置：

autogenerate.check_for_changes = True

配置完成后再运行alembic revision --autogenerate命令，若没有检测到模型变更，会直接输出No changes detected in schema提示，不会生成空迁移文件。
如果使用的是低于1.9.0的版本，可以在alembic/env.py文件中添加环境回调逻辑，检测到upgrade、downgrade均为空操作时主动终止迁移生成流程。

预先检测变更再执行迁移的方案 #

如果需要在脚本、CI/CD流程中自动判断是否需要执行迁移操作，可以用以下方案：
运行Alembic自带的检查命令：

alembic check

命令返回值为0代表无模型变更，返回非0代表存在未同步的模型变更，你可以在脚本中根据返回值判断是否要执行后续的alembic revision和alembic upgrade操作。

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