Flask Blueprint调用数据库报错：'function' object has no attribute 'query'

嘿，我刚帮好几个新手踩过这个Blueprint的坑，咱们一步步揪出问题所在，肯定是某个小细节没注意到～

最常见的原因：模型与视图函数重名 #

你有没有在代码里把模型类和视图函数取了同一个名字？比如：

# views.py里的视图函数
def User():
    return "用户页面"

# models.py里的模型
class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)

这种情况下，当你在视图里写User.query.all()时，Python会优先识别成视图函数（因为它在当前文件里），而视图函数是个function对象，自然没有query属性。

解决办法：给视图函数或者模型换个不重复的名字，比如视图函数改成get_user()，模型保持User。

第二大原因：模型没继承db.Model #

检查你的models.py，模型类必须继承自db.Model才能拥有query属性：

# 正确写法
from project import db

class User(db.Model):  # 必须继承db.Model
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True)

如果漏了db.Model，这个类就是普通Python类，没有ORM提供的query方法。

第三点：db的初始化与导入有问题 #

如果你用了Flask的应用工厂模式（也就是用create_app()函数创建app），一定要确保db是通过init_app()绑定到app的，而不是直接在初始化时传app：

项目根目录的__init__.py应该这么写： #

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

# 先初始化db，不传入app
db = SQLAlchemy()

def create_app():
    app = Flask(__name__)
    # 配置数据库链接
    app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///your_db.db'
    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

    # 把db绑定到当前app上
    db.init_app(app)

    # 注册Blueprint
    from .views import main_bp
    app.register_blueprint(main_bp)

    return app

app.py的启动代码： #

from project import create_app

app = create_app()

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

视图里的db和模型导入要正确： #

在views.py里，要从项目的__init__.py导入db，同时导入正确的模型类：

from flask import Blueprint
from project import db
from project.models import User  # 明确导入模型类，不是视图函数！

main_bp = Blueprint('main', __name__)

@main_bp.route('/')
def index():
    # 这里是模型类User调用query，不是其他对象
    users = User.query.all()
    return f"当前用户数：{len(users)}"

最后一个小坑：误把db当成模型用 #

有没有不小心写了db.query？正确的用法要么是Model.query，要么是db.session.query(Model)，直接调用db.query会报错，因为db是SQLAlchemy实例，它的query需要绑定具体模型。

按照上面的步骤逐一排查，应该就能解决这个问题啦！

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