如何在Flask应用URL端点外通过SQLAlchemy查询SQLite数据库并解决导入问题

问题核心在于循环导入（models依赖app内的db实例，外部任务重复创建app/db引发冲突）和相对导入的上下文缺失。要保留ORM模型的复用性，需通过重构项目结构解耦依赖，让外部任务直接复用原Flask应用的上下文。

步骤1：重构项目结构，抽离db实例到独立文件 #

新增app/extensions.py，将SQLAlchemy的db实例单独存放，彻底打破app与models的循环依赖：

# app/extensions.py
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

步骤2：修改app.py，从extensions初始化db #

不再在app.py内直接创建db，改为从extensions导入并绑定到Flask应用：

# app/app.py
from flask import Flask
from extensions import db
import os

app = Flask(__name__)
# 修正数据库路径，指向instance目录下的db.sqlite（符合Flask最佳实践）
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(app.instance_path, 'db.sqlite')
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False

# 初始化db与应用
db.init_app(app)

with app.app_context():
    # 导入模型确保被SQLAlchemy注册
    from models import TokenBlocklist
    db.create_all()

步骤3：修改models.py，从extensions导入db #

替换原有的相对导入逻辑，改为从extensions导入db实例：

# app/models.py
import uuid
from sqlalchemy import func  # 补充导入func，原代码遗漏该依赖
from extensions import db


def uuid_str():
    return str(uuid.uuid4())


class TokenBlocklist(db.Model):
    id = db.Column(
        db.String(36),
        primary_key=True,
        nullable=False,
        index=True,
        default=uuid_str
    )
    jti = db.Column(
        db.String(36),
        nullable=False,
        index=True
    )
    type = db.Column(
        db.String(10),
        nullable=False
    )
    created_at = db.Column(
        db.DateTime,
        nullable=False,
        server_default=func.now(),
        index=True
    )

步骤4：修改定时任务文件，复用原Flask应用上下文 #

不再重新创建app和db，直接导入原应用的实例，在上下文内执行数据库操作：

# app/scheduled_tasks/remove_old_tokens.py
import sys
import os
# 将项目根目录加入Python路径，确保能正确导入app模块
sys.path.append(os.path.abspath('../../'))

from datetime import datetime, timedelta
from app.app import app, db
from app.models import TokenBlocklist


def remove_old_tokens():
    with app.app_context():  # 推送应用上下文，确保SQLAlchemy能识别数据库配置
        forty_days = timedelta(days=40)
        forty_days_ago = datetime.now() - forty_days
        # 修正字段名：模型内是created_at，原代码误写为created
        query = TokenBlocklist.__table__.delete().where(TokenBlocklist.created_at < forty_days_ago)
        db.session.execute(query)
        db.session.commit()
        print('旧令牌已清理完成')

if __name__ == '__main__':
    remove_old_tokens()

关键说明 #

1. 解耦循环依赖：抽离db到extensions.py后，app和models均依赖第三方文件，而非互相引用，彻底解决循环导入问题。
2. 复用应用上下文：外部任务直接使用原应用的app和db实例，确保与主应用共享同一数据库配置，避免重复初始化导致的冲突。
3. 上下文必要性：所有数据库操作必须在Flask应用上下文内执行（通过with app.app_context()），否则SQLAlchemy无法获取数据库连接信息。

测试运行 #

在项目根目录执行定时任务：

python app/scheduled_tasks/remove_old_tokens.py

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