如何为Flask应用生成SQL转储？求Flask-AlchemyDumps替代方案

你遇到的ModuleNotFoundError: No module named 'flask.ext'是因为现代Flask版本已经弃用了flask.ext的导入方式，而且Flask-AlchemyDumps这个包确实多年没有维护（最后更新是2016年），完全不兼容Flask 2.x+、SQLAlchemy 2.x以及现在主流的Flask CLI（取代了旧的Flask-Script）。

下面是几个可靠的替代方案，按推荐度排序：

方案1：使用数据库原生备份工具（最推荐，生产环境首选） #

直接用数据库自带的dump/restore命令，效率最高、兼容性最好，适合任何规模的数据库：

针对SQLite #

添加Flask CLI命令调用sqlite3工具：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import click
import subprocess
from datetime import datetime

db = SQLAlchemy()
app = Flask(__name__)
app.config.from_object(Config)
db.init_app(app)

@app.cli.command("dump-sqlite")
@click.option("--output", default=f"db_dump_{datetime.now().strftime('%Y%m%d_%H%M%S')}.sql", help="输出SQL文件路径")
def dump_sqlite(output):
    """将SQLite数据库导出为SQL文件"""
    db_path = app.config['SQLALCHEMY_DATABASE_URI'].replace('sqlite:///', '')
    subprocess.run(f"sqlite3 {db_path} .dump > {output}", shell=True, check=True)
    click.echo(f"数据库已成功导出到 {output}")

@app.cli.command("restore-sqlite")
@click.option("--input", required=True, help="输入SQL备份文件路径")
def restore_sqlite(input):
    """从SQL文件恢复SQLite数据库"""
    db_path = app.config['SQLALCHEMY_DATABASE_URI'].replace('sqlite:///', '')
    # 清空现有数据库（可选，根据需求调整）
    subprocess.run(f"sqlite3 {db_path} 'DELETE FROM {table}'", shell=True)
    subprocess.run(f"sqlite3 {db_path} .read {input}", shell=True, check=True)
    click.echo(f"数据库已从 {input} 成功恢复")

针对PostgreSQL/MySQL #

• PostgreSQL：使用pg_dump导出，pg_restore恢复
• MySQL：使用mysqldump导出，mysql命令恢复

你可以类似上面的方式，把这些命令封装成Flask CLI命令，方便直接通过flask dump-pg之类的命令调用。

方案2：自定义Flask CLI命令实现JSON格式导出/导入 #

如果需要跨数据库兼容的备份格式（比如从SQLite迁移到PostgreSQL），可以自己写命令把数据序列化为JSON：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import click
import json
from datetime import datetime
from your_app.models import User, Post  # 替换成你的实际模型类

db = SQLAlchemy()
app = Flask(__name__)
app.config.from_object(Config)
db.init_app(app)

# 映射表名到模型类
MODEL_MAP = {
    User.__tablename__: User,
    Post.__tablename__: Post
}

@app.cli.command("dump-db")
@click.option("--output", default=f"db_dump_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json", help="输出JSON文件路径")
def dump_db(output):
    """将所有表数据导出为JSON文件"""
    backup_data = {}
    for table_name, model in MODEL_MAP.items():
        records = db.session.query(model).all()
        # 转换模型对象为字典，处理日期类型
        backup_data[table_name] = [
            {
                col.name: getattr(record, col.name).isoformat() 
                if isinstance(getattr(record, col.name), datetime) 
                else getattr(record, col.name)
                for col in model.__table__.columns
            }
            for record in records
        ]
    
    with open(output, 'w', encoding='utf-8') as f:
        json.dump(backup_data, f, indent=2, ensure_ascii=False)
    click.echo(f"数据已成功导出到 {output}")

@app.cli.command("restore-db")
@click.option("--input", required=True, help="输入JSON备份文件路径")
@click.option("--clear", is_flag=True, help="恢复前清空所有表数据")
def restore_db(input, clear):
    """从JSON文件恢复数据库数据"""
    with open(input, 'r', encoding='utf-8') as f:
        backup_data = json.load(f)
    
    if clear:
        # 按依赖顺序倒序清空表，避免外键约束错误
        with app.app_context():
            for table in reversed(db.metadata.sorted_tables):
                db.session.execute(table.delete())
            db.session.commit()
    
    for table_name, records in backup_data.items():
        model = MODEL_MAP.get(table_name)
        if not model:
            click.echo(f"警告：未找到表 {table_name} 对应的模型，跳过该表")
            continue
        
        for record in records:
            # 转换日期字符串为datetime对象
            for col in model.__table__.columns:
                if isinstance(col.type, db.DateTime) and record[col.name]:
                    record[col.name] = datetime.fromisoformat(record[col.name])
            db.session.add(model(**record))
    
    db.session.commit()
    click.echo(f"数据已从 {input} 成功恢复")

为什么不推荐继续用Flask-AlchemyDumps？ #

• 最后一次更新是2016年，仅支持Flask 0.12和SQLAlchemy 1.1，完全不兼容现代版本
• 依赖的Flask-Script已经被Flask原生的CLI功能取代
• 社区无维护，遇到问题无法获得支持

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