如何在执行flask run时自动创建默认guest演示用户？

要实现启动Flask服务器时自动生成guest/password的演示用户，核心是在应用启动阶段检查数据库中是否存在该用户，不存在则自动创建，避免手动操作，适配代码分发场景。

具体实现 #

方式一：启动时自动创建（推荐） #

在你的应用初始化文件（通常是app/__init__.py）中，添加用户检查与创建逻辑，确保服务启动时自动执行：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_bcrypt import Bcrypt
from flask_login import LoginManager

db = SQLAlchemy()
bcrypt = Bcrypt()
login_manager = LoginManager()

def create_app():
    app = Flask(__name__)
    # 加载应用配置，比如数据库连接信息
    app.config.from_object('config.Config')

    # 初始化扩展
    db.init_app(app)
    bcrypt.init_app(app)
    login_manager.init_app(app)

    # 注册蓝图
    from app.auth.views import auth
    app.register_blueprint(auth)
    # 注册其他业务蓝图...

    # --------------------------
    # 自动创建默认访客用户逻辑
    # --------------------------
    with app.app_context():
        # 首次启动时自动创建数据库表（若使用Flask-Migrate，可删除此行，改用flask db upgrade初始化）
        db.create_all()
        
        from app.models import User
        # 检查guest用户是否已存在
        guest = User.query.filter_by(username='guest').first()
        if not guest:
            # 创建用户，使用你的User类构造方法处理密码哈希
            new_guest = User(username='guest', password='password')
            db.session.add(new_guest)
            db.session.commit()
            print("默认访客用户已创建：用户名guest，密码password")

    return app

关键细节

• 应用上下文：必须通过app.app_context()包裹数据库操作，否则Flask-SQLAlchemy无法获取数据库连接。
• 幂等性保障：先查询再创建的逻辑避免了重复创建用户，不会触发用户名唯一约束的错误。
• 表初始化：db.create_all()仅适用于未使用迁移工具的场景，若用Flask-Migrate管理表结构，删除此行，提前执行flask db upgrade完成表初始化即可。

方式二：自定义CLI命令（按需创建） #

如果不需要启动时自动创建，可编写一个CLI命令让用户手动触发创建：

在app/__init__.py的create_app函数内添加：

@app.cli.command("create-guest")
def create_guest():
    """创建默认访客用户的CLI命令"""
    from app.models import User
    guest = User.query.filter_by(username='guest').first()
    if guest:
        print("访客用户已存在")
        return
    new_guest = User(username='guest', password='password')
    db.session.add(new_guest)
    db.session.commit()
    print("访客用户创建成功")

使用时执行命令：

flask create-guest

验证效果 #

启动服务时执行flask run，首次启动会在控制台看到创建成功的提示，后续启动则不会重复执行创建逻辑。用户可直接用guest/password登录测试应用。

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