Flask使用config.from_object()时遇SQLALCHEMY配置未识别错误

错误信息 #

RuntimeError: Either 'SQLALCHEMY_DATABASE_URI' or 'SQLALCHEMY_BINDS' must be set.

你的代码结构 #

init.py（注意：你写的init.py应为__init__.py，否则Python无法识别为包） #

from config import Config
from .models import User
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_login import LoginManager 

db = SQLAlchemy()

def create_app():
    app = Flask(__name__)

    app.config.from_object(Config)
    db.init_app(app)

config.py #

import os

class Config(object):
    DEBUG = True
    SECRET_KEY = os.urandom(12)
    SQLALCHEMY_TRACK_MODIFICATIONS = False
    SQLALCHEMY_DATABASE_URI = "sqlite:////home/zepp/project/users.db"

问题排查与解决 #

1. 修正包初始化文件名 #

Flask应用工厂模式要求包的初始化文件必须命名为__init__.py，如果你的文件是init.py，Python无法将其识别为包的一部分，会导致from config import Config导入失败，配置无法加载。立即将文件名改为__init__.py。

2. 调整模型导入时机 #

你在文件顶部直接导入了from .models import User，但此时db对象还未绑定任何Flask应用配置。models.py中定义的User类继承自db.Model，这会导致在create_app函数执行前就触发了db的初始化，此时配置还未加载，从而抛出错误。

修改__init__.py，将模型导入移到db.init_app(app)之后：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_login import LoginManager 

db = SQLAlchemy()
login_manager = LoginManager()

def create_app():
    app = Flask(__name__)
    from config import Config
    app.config.from_object(Config)
    
    db.init_app(app)
    login_manager.init_app(app)
    
    # 延迟导入模型，确保db已绑定应用配置
    from .models import User
    
    return app

3. 验证配置路径 #

检查SQLALCHEMY_DATABASE_URI中的路径是否正确：

• 确保/home/zepp/project/目录存在且有写入权限，否则SQLite无法创建数据库文件。
• 路径格式：SQLite的绝对路径需要四个斜杠（sqlite:////），你的写法是正确的，但需确认路径无误。

4. 确认文件目录结构 #

确保你的项目目录结构如下，避免导入路径错误：

project/
    __init__.py
    config.py
    models.py

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