如何在Flask项目中优雅配置SQLAlchemy，实现模型分离无循环引用？

核心思路是采用应用工厂模式配合SQLAlchemy的延迟初始化能力，先创建独立的db实例，再在应用初始化时绑定到Flask app，彻底避免循环引用问题。

推荐项目结构 #

your_flask_project/
├── app/
│   ├── __init__.py       # 初始化db、定义应用工厂
│   ├── models/
│   │   ├── __init__.py   # 可选：统一导出模型
│   │   ├── user.py       # 用户模型
│   │   └── post.py       # 文章模型
│   └── routes/           # 路由蓝图（可选）
│       └── main.py
├── config.py             # 数据库等配置
└── run.py                # 应用启动入口

各文件代码实现 #

1. app/__init__.py - 初始化db与应用工厂 #

from flask_sqlalchemy import SQLAlchemy

# 先创建SQLAlchemy实例，不传入Flask应用
db = SQLAlchemy()

def create_app():
    from flask import Flask
    app = Flask(__name__)
    # 加载配置文件
    app.config.from_object('config.Config')
    
    # 将db绑定到当前Flask应用
    db.init_app(app)
    
    # 注册路由蓝图（如果有）
    from .routes.main import main_bp
    app.register_blueprint(main_bp)
    
    return app

2. config.py - 数据库配置 #

class Config:
    # PostgreSQL连接字符串，替换为你的实际信息
    SQLALCHEMY_DATABASE_URI = 'postgresql://your_username:your_password@localhost/your_db_name'
    SQLALCHEMY_TRACK_MODIFICATIONS = False  # 关闭不必要的修改追踪，节省资源

3. 模型文件（如app/models/user.py） #

直接从app导入db即可，完全无需引用app.py：

from app import db

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)
    # 关联文章模型
    posts = db.relationship('Post', backref='author', lazy=True)

另一个模型示例app/models/post.py：

from app import db

class Post(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(120), nullable=False)
    content = db.Column(db.Text, nullable=False)
    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)

4. run.py - 启动应用 #

from app import create_app, db

app = create_app()

# 初始化数据库表（首次运行时执行，后续用迁移工具更稳妥）
with app.app_context():
    db.create_all()

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

为什么不会出现循环引用？ #

• db实例在app/__init__.py的顶层被创建，模型文件导入的是这个已经存在的db对象。
• 应用工厂函数create_app()是在运行时才会导入路由、模型等模块，此时db已经初始化完成，不会出现"互相导入"的循环问题。

如果需要使用数据库迁移工具（如Flask-Migrate），只需在create_app()中初始化Migrate即可，逻辑完全兼容这种结构。

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