Flask-Migrate结合pgvector时出现NameError：未自动导入pgvector

核心原因 #

Flask-Migrate底层依赖的Alembic，在生成迁移文件时不会自动导入第三方SQLAlchemy类型的依赖库，具体原因分这几点：

• Alembic的迁移生成逻辑只识别SQLAlchemy内置类型，像pgvector这种第三方扩展类型，它没法自动判断需要额外导入对应的库，所以生成的迁移文件里会出现pgvector.Vector()的代码，但不会补上import pgvector。
• 你用了应用工厂+蓝图模式，模型大概率是在蓝图模块里定义的。由于应用工厂是延迟初始化，Alembic扫描模型时，可能没触发模型模块里的import pgvector语句，导致它没意识到迁移文件需要这个导入。
• pgvector的Vector属于自定义SQLAlchemy类型，Alembic没有内置对它的支持，自然不会自动处理其依赖导入逻辑。

除手动添加外的解决方式 #

• 全局导入到迁移环境：找到项目里的migrations/env.py，在文件开头加上import pgvector，之后生成的所有迁移文件都会自动继承这个导入，不用每次手动修改。
• 调整模型导入时机：确保在模型模块顶部就导入pgvector，并且在应用工厂初始化SQLAlchemy后，显式加载所有蓝图的模型，让Alembic扫描时能捕捉到这个依赖。

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