使用Flask+SQLAlchemy创建数据库时反复报错，请求帮助

代码中的错误点 #

• 配置项拼写错误：app.config['SQLALCHEMY_TRACK_MODI']是错误写法，正确的配置键名应为SQLALCHEMY_TRACK_MODIFICATIONS，拼写错误会导致该配置不生效，引发资源追踪警告。
• 模型缺少主键：Item类未定义主键字段，SQLAlchemy要求所有数据库模型必须包含主键（通常用整数类型自增主键），否则无法生成合法的表结构。
• 代码执行顺序错误：db.create_all()放在了app.run()之后，而app.run()会启动Flask开发服务器并阻塞主线程，导致表创建代码永远无法执行。

修正后的完整代码 #

from flask import Flask, render_template
from flask_sqlalchemy import SQLAlchemy


app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///db.sqlite'
# 修正配置项名称
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)


class Item(db.Model):
    # 添加主键字段
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(100))


@app.route("/")
def home():
    return render_template('home.html')


if __name__ == '__main__':
    # 先在应用上下文内创建数据库表，再启动服务器
    with app.app_context():
        db.create_all()
    app.run()

补充说明 #

• 使用with app.app_context()是因为Flask 2.0+版本中，直接调用db.create_all()需要在应用上下文环境中执行，确保SQLAlchemy能正确读取应用配置。
• 修正后启动项目，db.sqlite文件会自动生成，同时item表也会被创建。

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