flask视图函数直接返回状态码的三种写法：一是元组形式return "msg", 404；二是元组含首部return "msg", {"x-auth": "1"}, 401；三是显式response("err", status=422)。
Flask视图函数直接返回状态码的三种写法
Flask里最简单的方式不是靠装饰器或全局配置，而是让视图函数返回一个带状态码的响应对象或元组。关键在于：返回值结构决定HTTP状态码，而不是靠修改response.status_code后再返回（那样无效）。
以下三种方式都可行，按推荐顺序排列：
- 返回元组：
(body, status_code)，例如return "Not Found", 404 - 返回元组：
(body, headers, status_code)，例如return "Unauthorized", {"X-Auth-Required": "true"}, 401 - 显式构造
Response对象：from flask import Response，然后return Response("Error", status=422)
第一种最常用，也最轻量；第三种适合需要精细控制响应头或内容类型的场景。
用make_response()包装字符串时别漏掉status参数
很多人习惯用make_response()统一构造响应，但容易忽略它默认返回200。如果你写了make_response("Bad Request")却没设status，浏览器收到的仍是200 OK——这会导致前端逻辑误判。
正确写法必须显式传入status参数：
from flask import make_response
<p>@app.route('/api/data')
def get_data():
if not has_permission():
return make_response("Forbidden", 403) # ✅ 正确
return make_response("OK", 200)
</p>
注意：make_response()的第二个位置参数就是status，不是关键字参数；如果想加headers，得用关键字形式：make_response("Error", 400, {"Content-Type": "application/json"})。
abort()和raise异常的区别与适用场景
abort(404)看起来方便，但它会立即中断请求、触发错误处理器（如@app.errorhandler(404)），不经过视图函数后续逻辑。这不是“返回状态码”，而是“中止并跳转到错误处理流程”。
所以：
- 要用自定义错误页、统一日志或额外响应头？选
abort()+@errorhandler - 只是临时判断后返回一个非200响应，且后续代码不该执行？
abort()够用 - 需要在返回前做清理、记录、或条件性地返回不同状态？必须用元组或
Response，不能用abort()
另外，abort()抛出的是NotFound、BadRequest等预定义异常，不是HTTPException子类的实例——这点在单元测试里容易踩坑，mock时要注意类型匹配。
JSON响应里设状态码的常见错误
用jsonify()时，状态码不能靠链式调用设置：jsonify({"error": "no data"}).status_code = 404是无效的，因为jsonify()返回的是已构建完毕的Response对象，但Flask不会读取这个被手动改过的status_code属性。
正确方式只有两种：
- 元组方式：
return jsonify({"error": "no data"}), 404 - 显式传参：
return jsonify({"error": "no data"}), 404, {"X-Retry-After": "60"}
别试图在jsonify()结果上调用status_code赋值，也别用make_response(jsonify(...))再设状态——那会多套一层响应包装，反而让Content-Type变成text/html，破坏JSON语义。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
