Skip to content
Lv3Flask 速成进度 7 / 8

第 7 章:数据库:模型、会话与迁移 ​

ORM 省掉的是拼 SQL,不是替你管事务。会话什么时候提交、什么时候关,才是真正要盯的地方。


学习目标 ​

  • 会定义模型与关系,并选对字段类型
  • 明白 db.session 与请求的关系,不再到处手动 commit
  • 会用 Flask-Migrate 做版本化迁移,而不是 create_all
  • 认出 N+1、会话泄漏这两个最常见的问题

7.1 先决定用不用 ORM ​

用 ORM直接写 SQL
表结构随代码演进,需要迁移复杂报表、多表联查、窗口函数
数据操作以对象方式表达性能敏感的热点查询
中小规模、团队协作已有 DBA 与 SQL 规范

两者可以共存:主流程用 ORM,复杂查询用 text() 写原生 SQL。

python
from sqlalchemy import text

rows = db.session.execute(text("SELECT region, SUM(amount) FROM orders GROUP BY region"))

7.2 初始化 ​

python
# app/extensions.py
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

db = SQLAlchemy()
migrate = Migrate()
python
# app/__init__.py
app.config["SQLALCHEMY_DATABASE_URI"] = os.environ.get("DATABASE_URL", "sqlite:///app.db")
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
db.init_app(app)
migrate.init_app(app, db)

SQLALCHEMY_DATABASE_URI 的驱动写法随 SQLAlchemy 2.x 有变化(如 postgresql+psycopg://),以官方文档为准。SQLite 只适合开发与小型单机。


7.3 模型与关系 ​

python
class User(db.Model):
    __tablename__ = "users"
    id = db.Column(db.Integer, primary_key=True)
    email = db.Column(db.String(120), unique=True, nullable=False, index=True)
    created_at = db.Column(db.DateTime, server_default=db.func.now())
    orders = db.relationship("Order", back_populates="user", lazy="select")

class Order(db.Model):
    __tablename__ = "orders"
    id = db.Column(db.Integer, primary_key=True)
    user_id = db.Column(db.Integer, db.ForeignKey("users.id"), nullable=False, index=True)
    amount_cents = db.Column(db.Integer, nullable=False)
    user = db.relationship("User", back_populates="orders")

四条经验:

  1. 表名显式写:__tablename__ 不写会用类名推导,改名时容易和迁移对不上;
  2. 外键一定加索引:联查与过滤都靠它;
  3. 金额用整数存分,别用浮点;
  4. 时间用 DateTime + 服务端默认值,别在 Python 里算时区。

7.4 会话:什么时候提交 ​

Flask-SQLAlchemy 3.x 的默认行为:

  • 每个请求一个 session,请求结束自动 remove;
  • 不会自动 commit(autocommit 模式早已废弃)。

所以要么显式提交,要么在请求结束时统一提交:

python
@app.post("/orders")
def create_order():
    order = Order(user_id=1, amount_cents=9900)
    db.session.add(order)
    db.session.commit()          # 显式
    return {"id": order.id}, 201
一次请求,一个会话,一次事务边界请求进入session 建立视图:读 / 改add / delete / querycommit事务提交 / 失败回滚teardown:session.remove连接归还池,会话清空三种会话姿势显式 commit(推荐)写操作结束后立即提交边界清楚,出错能明确回滚bulk 操作 + flush批量插入先 flush 再 commit减少往返,注意内存占用手动管理(不推荐)在后台线程里自己建 session忘了关就是连接泄漏多步写操作的原子性:把多次 add 放在同一个 commit 之前,失败时一起回滚。显式 try/except 里记得 db.session.rollback(),别只捕获不处理。

事务边界建议:一个业务动作一次 commit。别在循环里 commit,也别把整个请求包成一个巨型事务。


7.5 查询 ​

python
from sqlalchemy import select

# 单条
user = db.session.execute(select(User).where(User.email == "a@b.com")).scalar_one_or_none()

# 列表 + 排序 + 限制
orders = db.session.execute(
    select(Order).where(Order.user_id == 1).order_by(Order.id.desc()).limit(20)
).scalars().all()

# 分页(Flask-SQLAlchemy 提供)
page = db.paginate(select(Order).order_by(Order.id.desc()), page=1, per_page=20)

User.query 这种老写法仍可用,但 3.x 官方推荐 select() 风格,新代码别再用旧的。


7.6 迁移:别再 create_all ​

bash
flask db init          # 只做一次,生成 migrations/
flask db migrate -m "add orders table"
flask db upgrade       # 应用到数据库

三条纪律:

  1. 迁移脚本要进仓库,它和代码是同一份历史;
  2. 自动生成的脚本必须人工看:删列、改类型它经常猜错;
  3. 生产升级前先备份,upgrade 不是可逆的。

create_all 只适合"本地一次性造表",它不会记录版本,也没法应付后续变更。


7.7 两个高频问题 ​

问题表现修法
N+1 查询页面一慢,日志里同一条 SQL 刷几十次提前 selectinload / joinedload 预加载关系
连接泄漏跑一阵开始报 too many connections检查是否有自己建 session 的后台线程;确认 teardown 会 remove

N+1 的写法对比:

python
# 差:每条 order 都再查一次 user
orders = db.session.execute(select(Order)).scalars().all()
for o in orders:
    print(o.user.email)          # 每次触发一次查询

# 好:一次带出来
orders = db.session.execute(
    select(Order).options(db.joinedload(Order.user)
).scalars().all()

本章小结 ​

要点说明
ORM 选择主流程 ORM,复杂查询用原生 SQL
模型显式表名、外键索引、金额存分、时间用 DateTime
会话每请求一个,不自动 commit,显式提交
事务一个业务动作一次 commit,失败要 rollback
查询select() 风格,分页用 db.paginate
迁移init / migrate / upgrade,脚本进仓库并人工检查
性能用 joinedload / selectinload 避免 N+1

下一章 ​

测试与部署:怎么给这套结构写测试,以及从 Gunicorn 到 Nginx 的上线流程。

本文阅读--次|全站访问--次|访客--人