如何在Flask蓝图中正确导入SQLAlchemy的db实例？

你的核心问题是SQLAlchemy实例的初始化方式导致的循环导入和上下文问题，下面给出模块化Flask应用的标准解决方案：

第一步：重构SQLAlchemy实例定义 #

在项目根目录（与__init__.py同级）新建extensions.py文件，单独创建空的SQLAlchemy实例：

from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

第二步：修改__init__.py的应用工厂函数 #

把原有的db初始化逻辑改成导入extensions中的实例并延迟初始化：

from flask import Flask
from flask_cors import CORS
from .extensions import db  # 导入单独定义的db实例
from .config import PGHOST, PGUSER, PGPORT, PGDATABASE, PGPASSWORD
from .auth import auth_bp
from .user_ui import user_ui_bp


def create_app():
    app = Flask(__name__)
    CORS(app)
    app.config['SQLALCHEMY_DATABASE_URI'] = f"postgresql://{PGUSER}:{PGPASSWORD}@{PGHOST}:{PGPORT}/{PGDATABASE}"
    app.config['SECRET_KEY'] = "secret_key"
    
    # 用init_app完成db与app的绑定，避免直接在创建db时传入app
    db.init_app(app)

    # 注册蓝图
    app.register_blueprint(auth_bp)
    app.register_blueprint(user_ui_bp)

    return app

第三步：在蓝图和模型中导入正确的db实例 #

修改auth.py蓝图，直接从extensions导入db：

import datetime
import jwt
import bcrypt
from flask import Blueprint, request, jsonify
from .extensions import db  # 导入正确的db实例
from .db_utils import DbUser
from .config import SECRET_KEY

auth_bp = Blueprint('auth', __name__)

@auth_bp.route('/api/register', methods=["POST"])
def register():
    data = request.get_json()
    password = data['password'].encode('utf-8')

    # 哈希密码
    hashed_password = bcrypt.hashpw(password, bcrypt.gensalt())

    user = DbUser(username=data['username'], password=hashed_password.decode('utf-8'))
    db.session.add(user)
    db.session.commit()
    return jsonify({'message': 'User registered successfully'}), 201

同时修改模型文件db_utils.py，同样从extensions导入db来定义模型：

from .extensions import db

class DbUser(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)
    password = db.Column(db.String(200), nullable=False)
    # 其他字段按需添加

之前方法报错的原因 #

• 方法1：同一个Flask应用只能绑定一个SQLAlchemy实例，重复创建自然报错。
• 方法2：__init__.py导入了蓝图，蓝图又反向导入__init__.py中的db，形成循环依赖。
• 方法3：current_app.config['db']本身逻辑错误——db实例不会自动存入config；且在视图函数外调用current_app时，还未进入应用上下文，必然触发上下文错误。如果非要用上下文获取，需在视图函数内执行from flask import current_app，再通过db = current_app.extensions['sqlalchemy'].db获取，但远不如直接导入extensions中的db便捷。

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