Flask-Migrate命令失败时不显示错误信息求助

我们在使用Flask结合SQLAlchemy与Flask-Migrate开发时，此前一切正常，但近期遇到迁移命令执行失败时无错误信息输出，仅静默退出且返回码为1（echo $?显示1）。仅当存在合理失败原因（如多Head版本、无效迁移文件）时才会出现此情况，无错误时迁移可正常执行并输出日志。

当前环境版本 #

• Python 3.9.15
• Flask 1.1.2
• Werkzeug 1.0.1
• Flask-Migrate ^2.5.3

排查解决步骤 #

1. 强制开启详细日志输出 #

Flask-Migrate依赖的Alembic默认日志级别可能未捕获错误细节，直接使用 verbose 模式执行命令：

flask db upgrade -v

或者通过环境变量提升日志级别：

export ALCHEMY_LOG_LEVEL=DEBUG
flask db upgrade

2. 校验Alembic与Flask-Migrate版本兼容性 #

Flask-Migrate 2.5.3的依赖要求是alembic>=0.9，高版本Alembic可能存在日志行为变化。先查看当前Alembic版本：

pip show alembic

尝试切换到与Flask-Migrate 2.5.3匹配的稳定版本（如Alembic 1.4.x）：

pip install alembic==1.4.3

3. 检查Flask应用的日志配置 #

如果应用自定义了日志规则，可能覆盖了Alembic的日志输出。临时注释代码中类似以下的自定义日志配置，再执行迁移命令：

# 临时注释以下配置测试
import logging
logging.basicConfig(level=logging.INFO)

4. 绕开Flask-Migrate直接用Alembic测试 #

直接使用Alembic原生命令执行迁移，确认问题是否来自Flask-Migrate的封装：

1. 生成Alembic独立配置（若未存在）：

alembic init alembic

2. 修改alembic.ini中的数据库连接URL与Flask应用一致
3. 执行迁移：

alembic upgrade head

若此时能输出错误信息，说明问题出在Flask-Migrate的封装逻辑。

5. 检查迁移文件与版本表异常 #

• 手动查看数据库的alembic_version表，确认当前版本与迁移文件的一致性：

SELECT * FROM alembic_version;

• 检查migrations/versions目录下的迁移文件，是否存在重复版本号、格式错误，或多Head情况：

flask db heads

• 若存在多Head，手动合并解决：

flask db merge <head1版本号> <head2版本号> -m "Merge conflicting heads"

6. 回退到历史稳定版本 #

若怀疑是Flask-Migrate升级导致的问题，回退到之前使用的正常版本测试：

pip install flask-migrate==2.5.2

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