Flask-SQLAlchemy因导入顺序问题无法创建数据表该如何解决？

我习惯用以下结构搭建Flask应用：

init.py
├── app.py
├── models.py
├── init_db.py
├── some_db_helper.py
└── module_with_db_needs.py

所有初始化代码放在init.py：

# init.py
from flask import Flask
from flask_wtf.csrf import CSRFProtect
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config["SECRET_KEY"] = "abcd"

db = SQLAlchemy()
app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///testdata.sqlite3"
db.init_app(app)

csrf = CSRFProtect()
csrf.init_app(app)

models.py导入db定义模型：

# models.py
from sqlalchemy import Column, Integer
from init import db, app

class Category(db.Model):
    id = Column(Integer, primary_key=True, autoincrement=True)
    # ... 其他属性

app.py导入app编写路由：

# app.py
from init import app

@app.route("/index.html", methods=["GET"])
def index():
    return "OK"

init_db.py负责初始化数据库：

# init_db.py
from models import *

def insert_data():
    # 向Category表插入数据
    new_cat = Category()
    db.session.add(new_cat)
    db.session.commit()

with app.app_context():
    db.create_all()
    
insert_data()

运行python init_db.py时，数据库文件生成了，但未创建任何数据表，插入数据时报错：

sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) no such table: category

明明已经导入模型，且使用的是同一个db实例，为什么create_all()不创建表？

问题核心是操作数据库的代码未在激活的Flask应用上下文内执行，加上导入逻辑的小问题，按以下步骤修改即可：

1. 将数据插入操作移入应用上下文块
   db.create_all()是在with app.app_context()块内执行的，但insert_data()在块外，此时没有激活的上下文，无法正确绑定数据库连接和模型元数据。修改init_db.py：

# init_db.py
from models import *

def insert_data():
    new_cat = Category()
    db.session.add(new_cat)
    db.session.commit()

with app.app_context():
    db.create_all()
    insert_data()  # 将插入操作移到上下文块内执行

2. 明确导入模型，避免模糊导入的潜在问题
   用from models import *可能存在导入不完整的情况，建议明确导入需要的模型，同时先导入核心的app和db实例，确保上下文初始化顺序正确：

# init_db.py
from init import app, db
from models import Category  # 明确导入模型

def insert_data():
    new_cat = Category()
    db.session.add(new_cat)
    db.session.commit()

with app.app_context():
    db.create_all()
    insert_data()

3. 补充SQLAlchemy配置（可选）
   在init.py中添加配置禁用修改跟踪，避免运行时警告：

# init.py
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False

完成以上修改后，重新运行python init_db.py即可正确创建数据表并插入数据。

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