test_client 必须在 testing=true 下运行，否则会吞掉异常并返回 500 页面而非 json 错误；404 多因蓝图未注册或路由未加载；mock 应作用于使用位置而非定义位置；带 login_required 的接口需用 login_user 模拟登录态。
test_client 必须在 TESTING=True 下运行
不设 app.config['TESTING'] = True，test_client 会吞掉异常、返回 500 页面而非 JSON 错误，导致断言失效或掩盖真实问题。这不是可选配置，是强制前提。
实操建议：
- 在 fixture 中设置：
app.config['TESTING'] = True，不要只在测试函数里临时改 - 避免全局修改
app.debug = True—— 它可能触发额外日志或重定向逻辑，干扰测试稳定性 - 若用工厂函数（如
create_app()），确保测试用的 app 实例已明确传入TESTING=True配置
404 错误大概率是路由没注册，不是 URL 写错
调用 client.get('/api/users') 返回 404，但路由明明写了 @app.route('/api/users')？十有八九是蓝图没注册、模块没导入，或应用上下文未加载路由定义。
实操建议：
- 在 fixture setup 阶段加一行：
print(list(app.url_map.iter_rules()))，确认目标路由出现在输出里 - 检查是否用了蓝图：若
bp = Blueprint('user', __name__)，必须调用app.register_blueprint(bp, url_prefix='/api')，且该调用发生在app.test_client()创建之前 - 避免把
@app.route写在条件块里（如if app.env == 'development':），测试时环境变量不同会导致路由跳过
mock 数据库依赖要 patch “使用位置”，不是 “定义位置”
@patch('models.User') 却不起作用？因为你在 views.py 里写了 from models import User，然后调用 User.query.filter() —— 此时 patch 目标应是 'views.User'，即模块内实际引用的对象路径。
实操建议：
- 用 pytest-mock 的
mocker.patch()更安全：在测试函数参数中接收mocker，写成mocker.patch('views.User') - 设返回值链：例如
user_mock.query.filter.return_value.first.return_value = mock_user - 别 patch 整个
sqlalchemy或db模块 —— 容易漏掉 session commit、事务边界等关键行为
带 login_required 的接口不能靠删装饰器来测
直接注释掉 @login_required 看似省事，但等于绕过真实权限控制逻辑，测试失去意义。Flask-Login 的拦截机制会返回 302 重定向，而不是你期望的 200 JSON 响应。
实操建议：
- 用
login_user()注入登录态：with client.session_transaction() as sess: sess['_user_id'] = '1' - 或者更推荐：在 fixture 中复用 Flask-Login 提供的
login_user工具函数，传入一个 mock 用户对象 - 若接口返回重定向，需显式设
follow_redirects=True，否则response.status_code是 302 而非最终响应码
db.session.remove()，下一个测试就可能读到上一个测试残留的数据。这种问题不会报错，只会让断言偶尔失败，极难定位。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
