Flask连接SQL数据库报错：RuntimeError: Working outside of application context

问题描述 #

尝试将Flask应用连接SQL数据库时，抛出以下错误：

RuntimeError: Working outside of application context.

This typically means that you attempted to use functionality that needed
the current application. To solve this, set up an application context
with app.app_context(). See the documentation for more information.

参考官方文档给出的应用工厂模式代码示例：

def create_app():
    app = Flask(__name__)
    app.config.from_object("project.config")

    import project.models

    with app.app_context():
        db.create_all()

    return app

但无法理解import project.models的作用，且尝试导入时PyCharm提示不存在名为'project'的模块。以下是未修改前的完整代码：

from flask import Flask, redirect, url_for, render_template, request, session, flash, current_app
from datetime import timedelta
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)

app.secret_key = "hello"
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///users.sqlite3'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
app.permanent_session_lifetime = timedelta(days=1)

db = SQLAlchemy(app)


class users(db.Model):
    _id = db.Column("id", db.Integer, primary_key=True)
    name = db.Column(db.String(100))
    email = db.Column(db.String(100))

    def __init__(self, name, email):
        self.name = name
        self.email = email


@app.route("/")
def home():
    return render_template('index.html')

@app.route('/login', methods=['POST', 'GET'])
def login():
    if request.method == "POST":
        session.permanent = True
        user = request.form["nm"]
        session["user"] = user
        flash("Login successful.", "info")

        return redirect(url_for("user"))
    else:
        if "user" in session:
            flash("Already logged in.")
            return redirect((url_for("user")))
        return render_template("login.html")

@app.route('/user', methods=["POST", "GET"])
def user():
    email = None
    if "user" in session:
        user = session["user"]
        if request.method == "POST":
            email = request.form["email"]
            session["email"] = email
            flash("Email was saved!")
        else:
            if "email" in session:
                email = session["email"]
        return render_template("user.html", email=email)
    else:
        flash("Not logged in.")
        return redirect(url_for("login"))

@app.route("/logout")
def logout():
    flash("You have been logged out", "info")
    session.pop("user", None)
    session.pop("email", None)
    return redirect((url_for("login")))


if __name__ == "__main__":
    db.create_all()
    app.run(debug=True)

问题分析与解决方案 #

1. 错误根源 #

你直接在if __name__ == "__main__"中调用db.create_all()时，没有激活Flask的应用上下文。SQLAlchemy需要通过应用上下文获取当前应用的数据库配置，没有上下文就会抛出上述错误。

2. 关于import project.models的解释 #

这是应用工厂模式下的写法：

• project是你的项目根模块名称（对应一个同名文件夹）
• project.models是存放数据库模型的文件，导入它是为了让SQLAlchemy识别所有定义的模型类，否则db.create_all()不会创建对应的表。
• 你的代码是单文件结构，不需要这种导入方式。

3. 快速修复你的代码 #

无需重构为应用工厂模式，只需在调用db.create_all()时激活应用上下文即可。修改主函数部分：

if __name__ == "__main__":
    with app.app_context():
        db.create_all()
    app.run(debug=True)

with app.app_context()会临时激活应用上下文，确保db.create_all()能正常读取配置并创建表。

4. 若后续改用应用工厂模式（可选） #

当项目规模扩大时，推荐使用应用工厂模式，步骤如下：

1. 创建名为project的文件夹（作为根模块），内部添加__init__.py
2. 在project下创建models.py，将users模型类移到这里
3. 在project下创建config.py，存放应用配置（如数据库URI、密钥等）
4. 在project/__init__.py中编写应用工厂函数，此时import project.models就能正确导入模型，让SQLAlchemy识别并创建表。

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