Skip to content
Lv3Flask 速成进度 8 / 8

第 8 章:测试与部署上线 ​

写测试不是为了覆盖率好看,是为了让"改一个路由"不再需要手动点一遍全站。


学习目标 ​

  • 用 fixture 给每个用例一个干净的 app 与数据库
  • 会测状态码、JSON 结构、权限与错误路径
  • 把 Gunicorn 与 Nginx 配到能扛住真实流量
  • 有一份上线前逐项打勾的清单

8.1 最小测试骨架 ​

python
# tests/conftest.py
import pytest
from app import create_app
from app.extensions import db

@pytest.fixture
def app():
    app = create_app("app.config.TestingConfig")
    with app.app_context():
        db.create_all()
        yield app
        db.session.remove()
        db.drop_all()

@pytest.fixture
def client(app):
    return app.test_client()
python
# tests/test_orders.py
def test_create_order(client):
    resp = client.post("/orders", json={"amount_cents": 9900})
    assert resp.status_code == 201
    assert resp.get_json()["id"] == 1

def test_create_order_rejects_bad_payload(client):
    resp = client.post("/orders", json={})
    assert resp.status_code == 400

三个要点:

  1. 每个用例新建 app:避免配置与数据互相污染;
  2. 测试用内存库:sqlite:///:memory:,跑完即弃;
  3. db.create_all() 代替迁移:测试要快,结构直接建。

8.2 该测什么 ​

类型例子价值
状态码201 / 400 / 401 / 404前端联调的第一道保证
JSON 结构必填字段存在、类型正确防止改字段名把前端搞崩
权限未登录 401、越权 403安全问题最值得自动化
边界空列表、超长字符串、非法类型线上最容易炸的地方
错误路径数据库异常时返回 500 且不泄漏细节避免把堆栈暴露给用户

一个实用习惯:每个 POST 接口至少四条用例——成功、参数缺失、类型错误、无权限。


8.3 测试里的三个陷阱 ​

陷阱现象修法
复用同一个 app第二个用例看到第一个的数据fixture 里新建 app
忘记 app_context直接操作 db 报上下文错误fixture 里 with app.app_context()
依赖真实外部服务CI 上时通时不通用 monkeypatch 打桩,或跑本地容器
python
def test_send_email(client, monkeypatch):
    monkeypatch.setattr("app.services.email.send", lambda *a, **k: True)
    resp = client.post("/notify", json={"to": "a@b.com"})
    assert resp.status_code == 200

8.4 Gunicorn:把应用跑起来 ​

bash
gunicorn "app:create_app()" \
  --workers 4 \
  --threads 2 \
  --timeout 30 \
  --graceful-timeout 30 \
  --bind 0.0.0.0:8000 \
  --access-logfile - \
  --error-logfile -
参数怎么定
workers从 2 * CPU + 1 起试,真正约束是内存
threadsI/O 多的应用可加线程;纯 CPU 密集别加
timeout大于最慢请求;超时 worker 会被杀掉重启
graceful-timeout滚动重启时给在途请求留的时间

别用 --preload 又开多 worker 如果你的应用在导入时连数据库——每个 worker 会继承同一个连接,容易出怪问题。


8.5 Nginx:站在前面 ​

nginx
server {
    listen 443 ssl;
    server_name example.com;

    client_max_body_size 10m;

    location /static/ {
        alias /srv/myapp/app/static/;
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 60s;
    }
}

Nginx 做四件事:终止 TLS、发静态文件、限流与超时、加转发头。

Flask 侧要认这些头,否则拿到的客户端 IP 永远是 127.0.0.1:

python
from werkzeug.middleware.proxy_fix import ProxyFix
app.wsgi_app = ProxyFix(app.wsgi_app, x_for=1, x_proto=1, x_host=1)
上线后的真实链路浏览器HTTPS 443NginxTLS 终止/static/ 直接返回限流 / 超时 / 转发头8000 端口不对外GunicornN 个 worker超时杀进程、滚动重启每个 worker 一份 app--preload 谨慎用Flask蓝图 + 视图ProxyFix日志到 stdout数据库连接池上限要算容量算法数据库最大连接数 ≥ 所有实例的(worker 数 × 连接池大小)+ 迁移/运维预留上线顺序备份数据库 → 跑迁移 → 更新代码 → 重启 worker(graceful)→ 健康检查 → 观察日志 5 分钟顺序别改:先迁移再启动新代码,新旧代码要兼容同一份表结构(做两阶段变更)。

8.6 上线清单 ​

项检查点
配置SECRET_KEY、数据库 URI 从环境变量读,代码里无硬编码
调试DEBUG=False,错误页不显示堆栈
迁移已备份,flask db upgrade 执行成功
服务器Gunicorn 多 worker,--timeout 已设
反代Nginx 终止 TLS、发静态文件、client_max_body_size 与上传上限一致
头ProxyFix 生效,日志里能看到真实 IP
日志应用日志到 stdout,由容器/系统收集;不写本地文件
健康检查/health 返回 200 且不查重资源
会话Cookie Secure + HttpOnly,跨站策略明确
备份数据库定时备份,恢复流程演练过

8.7 容器化的最小 Dockerfile ​

dockerfile
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt gunicorn
COPY . .
ENV PYTHONUNBUFFERED=1
EXPOSE 8000
CMD ["gunicorn", "app:create_app()", "-w", "4", "--timeout", "30", "-b", "0.0.0.0:8000"]

四个细节:PYTHONUNBUFFERED=1 让日志实时输出、依赖先拷贝以利用层缓存、别把 .env 打进镜像、CMD 用 exec 形式以便正确接收信号。


本章小结 ​

要点说明
测试骨架fixture 新建 app、内存库、create_all
该测什么状态码、JSON 结构、权限、边界、错误路径
测试陷阱复用 app、缺上下文、依赖外部服务
Gunicornworker 由内存定、timeout 大于最慢请求
NginxTLS、静态、限流、转发头
ProxyFix不配就拿不到真实 IP
上线顺序备份 → 迁移 → 发布 → 重启 → 健康检查

全课收尾 ​

八章下来:

定位(1)→ 路由(2)→ 请求响应(3)→ 模板(4)→ 工厂与配置(5)→ 蓝图(6)→ 数据库(7)→ 测试部署(8)

一句话记住:Flask 不替你决定架构,所以你必须在第 5 章之前就想清楚——不然写到第 6 章就得推倒重来。

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