使用应用工厂与蓝图集成Flask-PyMongo遇AttributeError问题求助

嘿，这个问题我之前帮人排查过好多次啦，应用工厂模式下用Flask-PyMongo最容易踩的就是实例绑定的坑，咱们一步步来捋清楚你为啥会碰到AttributeError: 'Flask' object has no attribute 'db'这个错误，以及怎么解决。

问题根源 #

在应用工厂模式里，Flask实例是通过create_app()函数动态创建的，而不是全局存在的。如果你直接在蓝图里尝试访问某个全局的app.db，或者PyMongo的初始化方式不对，就会出现找不到db属性的情况。

正确的配置步骤（结合常见目录结构） #

假设你的项目结构是这样的：

your_project/
    __init__.py       # 应用工厂在这里
    endpoints.py      # 蓝图路由
    run.py            # 启动脚本

1. 顶层__init__.py的应用工厂配置

先初始化PyMongo实例（不要直接传入app），再在工厂函数里绑定到创建的Flask实例上：

from flask import Flask
from flask_pymongo import PyMongo
from .endpoints import bp  # 导入你的蓝图

# 先创建PyMongo实例，暂不关联Flask app
mongo = PyMongo()

def create_app():
    app = Flask(__name__)
    
    # 配置MongoDB连接地址，替换成你自己的URI
    app.config["MONGO_URI"] = "mongodb://localhost:27017/your_database_name"
    
    # 把PyMongo实例和当前创建的Flask app绑定
    mongo.init_app(app)
    
    # 注册蓝图
    app.register_blueprint(bp)
    
    return app

2. endpoints.py的蓝图路由写法

不要直接找app.db，而是用下面两种方式之一访问数据库：

方式一：导入全局的PyMongo实例

from flask import Blueprint
from . import mongo  # 从__init__.py导入我们创建的mongo实例

bp = Blueprint('api', __name__)

@bp.route('/get-data')
def get_data():
    # 直接用mongo.db操作数据库
    sample_data = mongo.db.your_collection.find_one()
    return str(sample_data)

方式二：使用current_app获取当前app实例

from flask import Blueprint, current_app

bp = Blueprint('api', __name__)

@bp.route('/get-data')
def get_data():
    # 通过current_app拿到已绑定db的当前app实例
    sample_data = current_app.db.your_collection.find_one()
    return str(sample_data)

3. 启动脚本run.py的正确写法

必须通过应用工厂创建Flask实例，不能直接用全局app：

from your_project import create_app

app = create_app()

if __name__ == '__main__':
    app.run(debug=True)

你可能遗漏的细节 #

• 没有用mongo.init_app(app)来绑定实例，而是直接在工厂里写mongo = PyMongo(app)——这种写法会导致蓝图导入时，mongo还没和正确的app实例绑定
• 蓝图里直接引用了某个未经过工厂初始化的全局Flask实例，而这个实例根本没配置过PyMongo
• 忘记在app.config里设置MONGO_URI，导致PyMongo初始化失败，自然不会给app添加db属性

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