Flask test_client能不走网络是因为它直接调用WSGI应用逻辑，绕过socket、DNS、SSL等所有网络层；最小单测需设app.config['TESTING']=True，用with app.test_client()上下文，正确传参（如URL参数拼路径、表单用data、JSON用json=），mock外部依赖时patch须作用于被调用位置且嵌套在client上下文中。
Flask test_client 为什么能不走网络
因为 test_client 不是发 HTTP 请求，它直接调用 Flask 内部的 WSGI 应用逻辑，把请求字典喂给 app.wsgi_app，绕过 socket、DNS、代理、SSL 所有网络层。你看到的 response.data 是 WSGI 返回的 bytes，不是抓包工具里那个 TCP 包。
所以它天然支持离线测试——哪怕你拔了网线、没装 requests、甚至没配 DNS，只要 Flask app 能 import，test_client 就能跑。
怎么写一个能跑通的最小单测
别一上来就 mock 数据库或 g 对象，先验证路由和视图函数本身是否可调用。关键点：用 with app.test_client() as client: 上下文管理，确保请求上下文正确激活。
-
app.config['TESTING'] = True必须设，否则异常会 500 而不是抛出，debug 时卡死 - GET 请求直接用
client.get('/api/user')；POST 带 JSON 用client.post('/login', json={'u': 'a', 'p': 'b'}) - 检查响应：用
response.status_code == 200，别只看response.data内容，状态码错了一切白搭 - 如果视图里用了
url_for()，它默认生成的是带域名的绝对 URL（如http://localhost/login），但测试时你通常要它返回相对路径，得加_external=False
test_client 拿不到 request.args 或 form？常见参数陷阱
不是拿不到，是传法不对。query string 和 form data 的构造方式完全不同，混淆就会返回空字典。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
立即学习“Python免费学习笔记（深入）”；
- URL 参数（
request.args）必须拼在 path 后面：client.get('/search?q=py&limit=10')，不能用query_string={'q': 'py'}—— 这个参数名已废弃，新版 Flask 会静默忽略 - 表单提交（
request.form）要用data+content_type='application/x-www-form-urlencoded'，或者更简单：用data={'username': 'x'}（Flask 自动识别为表单） - JSON 请求体（
request.get_json()）必须用json=...参数，不要手动序列化再塞进data，否则content_type不对，Flask 不解析 - 上传文件用
data={'file': (io.BytesIO(b'abc'), 'test.txt')}，注意元组结构，缺一个元素就报KeyError: 'filename'
mock 外部依赖时，test_client 和 patch 怎么共存
test_client 负责模拟请求入口，真正要隔离的是视图函数内部调用的外部服务（比如调第三方 API 的 requests.get 或数据库查询）。这时得靠 unittest.mock.patch，但它必须作用在被测函数「实际导入的位置」，不是你 import 的地方。
- 错误写法：
@patch('myapp.views.requests')→ 如果 views 里是from requests import get，就得 patch'myapp.views.get' - 推荐写法：在测试方法里用
with patch('myapp.services.pay_with_stripe') as mock_pay:，然后mock_pay.return_value = {'ok': True} - 注意上下文顺序：
with app.test_client() as client:和with patch(...) as m:要嵌套，且 patch 必须在 client 调用前生效 - 如果视图用了
g.db，别 mock 整个g，而是 mockg.db.execute等具体方法，避免影响其他测试用例
最常被忽略的是：patch 生效位置和 app.test_client() 的上下文生命周期。漏掉任何一个，mock 就像没写。
