第 3 章:请求与响应
视图函数的两件事:从
request里取到该取的,把该返回的返回对。
学习目标
- 区分
args/form/json,不再拿错容器 - 会给上传做大小限制与文件名清洗
- 分得清四种返回写法,知道什么时候该用
Response - 会把横切逻辑放进请求钩子,而不是塞进每个视图
3.1 request 上的六个入口
| 属性 | 取什么 | 典型场景 |
|---|---|---|
request.args | 查询串(?a=1) | 搜索、分页、筛选 |
request.form | 表单体(application/x-www-form-urlencoded 或 multipart) | 登录、提交表单 |
request.json | JSON 体(要求 Content-Type: application/json) | 前端接口 |
request.files | 上传文件 | 头像、导入 |
request.headers | 请求头 | 鉴权、UA、语言 |
request.cookies | Cookie | 会话标识 |
常见错误:前端发 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}三条硬要求:
- 必须清洗文件名:
secure_filename会移除路径分隔符与..,否则可能被写到任意位置; - 必须限制大小:
MAX_CONTENT_LENGTH超限时 Flask 直接返回 413,别等到磁盘满; - 不要相信扩展名判断类型:要用
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 resp3.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 请求钩子
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 最舒服的部分。