使用Flask-Migrate执行migrate命令时报错：option values must be strings

嘿，我之前在使用Flask-Migrate时也踩过不少类似的坑，结合你描述的情况（db init正常但db migrate报错），给你整理几个高频排查和解决方向：

1. 检查manager.py的核心配置是否完整 #

这是最容易出问题的环节，尤其是模型导入和Migrate初始化部分，给你一个标准的配置示例对照：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_script import Manager
from flask_migrate import Migrate, MigrateCommand

# 初始化Flask应用
app = Flask(__name__)
# 配置数据库链接（替换成你的实际地址）
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///your_database.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

# 初始化数据库和迁移工具
db = SQLAlchemy(app)
migrate = Migrate(app, db)

# 配置命令管理器
manager = Manager(app)
manager.add_command('db', MigrateCommand)

# 关键！必须导入所有需要迁移的模型类
# 如果你把模型放在models.py里，就加这一行
from models import *

if __name__ == '__main__':
    manager.run()

重点提醒：如果没有导入模型类，Flask-Migrate会识别不到任何需要迁移的表结构，直接触发报错。

2. 验证数据库连接是否正常 #

确保SQLALCHEMY_DATABASE_URI配置正确，能正常连接到目标数据库。你可以在manager.py里临时加一段测试代码，快速验证：

with app.app_context():
    try:
        db.session.execute('SELECT 1')
        print("✅ 数据库连接正常")
    except Exception as e:
        print(f"❌ 数据库连接失败：{str(e)}")

如果连接失败，先解决数据库的访问权限、地址或账号密码问题，再尝试迁移。

3. 排查依赖版本兼容性问题 #

你使用的是Python3.6，部分新版本的Flask生态依赖可能不再支持这个版本，建议锁定兼容的版本：

pip install flask==1.1.2 flask-sqlalchemy==2.4.4 flask-migrate==2.5.3 flask-script==2.0.6

版本不兼容是隐性报错的常见原因，回退到稳定兼容的版本往往能解决问题。

4. 重置迁移目录（谨慎操作） #

如果之前的migrations目录存在损坏或配置错误，可以尝试重置：

# 删除现有迁移目录（会丢失历史迁移记录）
rm -rf migrations
# 重新初始化
python manager.py db init
# 生成新的迁移脚本
python manager.py db migrate -m "initial migration"

如果以上方法都没解决，建议把报错Traceback的完整内容贴出来，这样能更精准定位具体问题。

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