第 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三个要点:
- 每个用例新建 app:避免配置与数据互相污染;
- 测试用内存库:
sqlite:///:memory:,跑完即弃; 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 == 2008.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 起试,真正约束是内存 |
threads | I/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)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、缺上下文、依赖外部服务 |
| Gunicorn | worker 由内存定、timeout 大于最慢请求 |
| Nginx | TLS、静态、限流、转发头 |
| ProxyFix | 不配就拿不到真实 IP |
| 上线顺序 | 备份 → 迁移 → 发布 → 重启 → 健康检查 |
全课收尾
八章下来:
定位(1)→ 路由(2)→ 请求响应(3)→ 模板(4)→ 工厂与配置(5)→ 蓝图(6)→ 数据库(7)→ 测试部署(8)
一句话记住:Flask 不替你决定架构,所以你必须在第 5 章之前就想清楚——不然写到第 6 章就得推倒重来。