Skip to content
Lv3Flask 速成进度 3 / 8

第 3 章:请求与响应 ​

视图函数的两件事:从 request 里取到该取的,把该返回的返回对。


学习目标 ​

  • 区分 args / form / json,不再拿错容器
  • 会给上传做大小限制与文件名清洗
  • 分得清四种返回写法,知道什么时候该用 Response
  • 会把横切逻辑放进请求钩子,而不是塞进每个视图

3.1 request 上的六个入口 ​

属性取什么典型场景
request.args查询串(?a=1)搜索、分页、筛选
request.form表单体(application/x-www-form-urlencoded 或 multipart)登录、提交表单
request.jsonJSON 体(要求 Content-Type: application/json)前端接口
request.files上传文件头像、导入
request.headers请求头鉴权、UA、语言
request.cookiesCookie会话标识

常见错误:前端发 JSON,后端用 request.form 取,结果永远是空字典。判断依据是 Content-Type,不是"看起来像 JSON"。

python
@app.post("/orders")
def create_order():
    if request.is_json:
        data = request.get_json()
    else:
        data = request.form.to_dict()

request.get_json() 在 Content-Type 不对时会抛 415;用 get_json(silent=True) 则返回 None,适合宽容处理。


3.2 上传文件 ​

python
app.config["MAX_CONTENT_LENGTH"] = 10 * 1024 * 1024   # 10 MB

@app.post("/upload")
def upload():
    f = request.files.get("file")
    if not f or f.filename == "":
        return {"error": "no_file"}, 400

    from werkzeug.utils import secure_filename
    name = secure_filename(f.filename)        # 去掉 ../ 与危险字符
    f.save(f"{UPLOAD_DIR}/{name}")
    return {"name": name}

三条硬要求:

  1. 必须清洗文件名:secure_filename 会移除路径分隔符与 ..,否则可能被写到任意位置;
  2. 必须限制大小:MAX_CONTENT_LENGTH 超限时 Flask 直接返回 413,别等到磁盘满;
  3. 不要相信扩展名判断类型:要用 python-magic 之类读真实类型,或者只允许白名单。

3.3 四种返回写法 ​

python
return "text"                                   # 200,text/html
return {"ok": True}                             # 200,application/json(自动)
return "<h1>hi</h1>", 201                       # 状态码
return {"err": "bad"}, 400, {"X-Trace": "..."}  # (体, 状态码, 响应头)
return Response(stream, mimetype="text/event-stream")   # 精细控制

make_response 适合"先拿到响应再改":

python
resp = make_response(render_template("index.html"))
resp.set_cookie("theme", "dark", max_age=3600)
return resp

3.4 跳转与中止 ​

python
from flask import redirect, abort

@app.get("/old")
def old():
    return redirect(url_for("new"), code=301)   # 永久跳转

@app.get("/admin")
def admin():
    if not current_user.is_admin:
        abort(403)                              # 交给 errorhandler 处理

abort 的价值是不用在每个视图里写"返回错误页",统一由 @app.errorhandler(403) 兜住。


3.5 请求钩子 ​

一次请求里,钩子出现的四个位置1 请求进入before_request鉴权、限流、读 g返回非 None 直接短路(不再进视图)视图函数业务逻辑拿 request,返回响应after_request加响应头、压缩、CORS必须返回响应对象2 响应返回teardown_request(无论成功或异常都会执行)关数据库会话、释放临时资源、清理 g 上的东西顺序要点:before 是"栈"(后注册先执行),after 是"队列"(后注册后执行)。

g 是请求级的临时储物柜:

python
@app.before_request
def load_user():
    g.user = verify_token(request.headers.get("Authorization"))   # 可能为 None

@app.get("/me")
def me():
    if not g.user:
        abort(401)
    return {"id": g.user.id}

不要把用户 ID 挂在模块级全局变量上——那是多线程下最经典的数据串号事故。


3.6 请求上下文与应用上下文 ​

两个概念容易混:

上下文里面有什么时候推送
请求上下文request、session每个请求进入时
应用上下文current_app、g请求时自动推送;脚本里要手动

在脚本里(不通过请求)用 current_app:

python
with app.app_context():
    db.create_all()

报 Working outside of application context 就是这个原因——不是代码错,是少了个上下文。


3.7 三个容易踩的坑 ​

坑表现修法
JSON 取不到request.form 是空 ImmutableMultiDict改用 get_json(),并检查 Content-Type
上传写到了别处文件路径被 ../ 穿越secure_filename + 固定目录
钩子里漏 return视图被跳过但没响应内容before_request 短路时返回合法响应

本章小结 ​

要点说明
取数据args 查询、form 表单、json 接口、files 上传
上传secure_filename + MAX_CONTENT_LENGTH + 类型白名单
返回字符串 / 字典 / 元组 / Response 四选一
跳转与错误redirect + abort,统一交给 errorhandler
钩子before 鉴权、after 加头、teardown 清理
上下文脚本里用 app_context()
g请求级存储,别用模块级全局变量

下一章 ​

模板:Jinja2 的继承、宏与自动转义,以及为什么"页面渲染"是 Flask 最舒服的部分。

本文阅读--次|全站访问--次|访客--人