pytest+Flask测试应使用app.test_client()模拟请求,配content_type='application/json'发POST,用app.app_context()支持数据库,断言用response.get_json()防编码错误。

pytest + Flask 测试前必须调用 app.test_client()
Flask 应用本身不自带 HTTP 服务器上下文,直接用 requests 访问本地 app.run() 启的服务既慢又不可靠(端口冲突、异步阻塞、无法控制生命周期)。正确做法是用 Flask 内置的测试客户端:app.test_client()。它不启动真实 HTTP 服务,而是模拟 WSGI 调用,返回标准 Response 对象,可直接断言状态码、JSON 数据、headers。
常见错误是忘记传入 app 实例,或在测试函数里重复初始化 app 导致配置丢失。推荐用 pytest fixture 封装:
import pytest
from myapp import create_app
<p>@pytest.fixture
def client():
app = create_app('testing') # 确保加载测试配置
app.config['TESTING'] = True
with app.test_client() as client:
yield client</p>
这样每个测试函数拿到的都是干净、隔离的 client 实例。
测试 POST JSON 接口时必须设 content_type='application/json'
Flask 的 request.get_json() 默认只在 Content-Type 为 application/json 时解析 body。如果只传 json=... 但没设类型,request.get_json() 返回 None,导致 400 或逻辑错误。
正确写法只有两种:
- 用
client.post('/api/login', json={'user': 'a', 'pwd': '123'})—— pytest 会自动加 header 和序列化 - 手动构造:
client.post('/api/login', data=json.dumps({'user': 'a'}), content_type='application/json')
注意:不要混用 json=... 和 data=...,pytest 会报错;也不要漏掉 content_type 却指望 data 自动识别。
需要数据库交互时,用 app.app_context() 而非 app.test_request_context()
如果你的接口内部调用了 SQLAlchemy 模型(比如 User.query.filter(...).first()),仅靠 test_client() 不足以激活 Flask-SQLAlchemy 的上下文。此时必须显式进入应用上下文,否则会抛 RuntimeError: Working outside of application context。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
正确做法是在 fixture 或测试函数中包裹:
with app.app_context():
# 初始化测试数据库、插入 mock 数据
db.create_all()
u = User(username='test')
db.session.add(u)
db.session.commit()
别用 test_request_context() —— 它只模拟请求上下文,不激活扩展(如 SQLAlchemy、Redis)注册的全局对象。
断言 JSON 响应优先用 response.get_json(),别手动 json.loads(response.data)
response.data 是 bytes,直接 json.loads(response.data) 会因编码问题失败(比如含中文时抛 UnicodeDecodeError)。而 response.get_json() 内部已处理编码、content-type 校验和解析异常,返回 dict 或 None(当解析失败或非 JSON 响应时)。
典型断言模式:
rv = client.post('/api/login', json={'user': 'admin'})
assert rv.status_code == 200
data = rv.get_json()
assert data['token'] is not None
assert 'user' in data
如果接口可能返回非 JSON(如 400 错误时返回纯文本),先检查 rv.content_type == 'application/json' 再调 get_json(),避免 None 上取键报错。
真正麻烦的是跨请求状态保持(比如登录后测受保护接口),得手动传 Cookie 或提取 token 放 header;这部分没封装好,很容易让测试变成“顺序强依赖”。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










