使用Flask-Migrate与PostGIS时spatial_ref_sys表迁移报错排查

核心原因：include_object函数未正确绑定到Alembic上下文 #

很多人修改env.py添加了include_object函数但没生效，根本原因是没把函数绑定到context.configure的参数里，Alembic根本不会调用它。

正确修改步骤： #

1. 在env.py中定义过滤函数：

def include_object(object, name, type_, reflected, compare_to):
    # 过滤spatial_ref_sys表
    if type_ == "table" and name == "spatial_ref_sys":
        return False
    # 其他对象正常处理
    return True

2. 找到run_migrations_online函数里的context.configure调用，添加include_object=include_object参数：

with connectable.connect() as connection:
    context.configure(
        connection=connection,
        target_metadata=target_metadata,
        include_object=include_object,  # 这行必须加！
        # 保留原有其他参数，比如render_as_batch等
    )

额外注意事项： #

• 若已生成迁移脚本：如果之前flask db migrate已经生成了包含DROP TABLE spatial_ref_sys的迁移文件，修改env.py不会影响已有脚本，必须手动打开对应迁移文件删掉这条语句。
• 调试判断逻辑：可以在include_object里加打印print(type_, name)，执行flask db migrate时看输出，确认是否识别到了目标表，避免大小写或type_判断错误（PostgreSQL表名默认小写）。
• 替代方案：如果还是不行，直接手动编辑迁移脚本，删除所有涉及spatial_ref_sys的DDL语句，后续生成迁移时记得先过滤再执行migrate。

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