Flask 中 before_request、after_request、teardown_request 有什么区别？

简化版

before_request 在视图执行前运行，可以做认证、鉴权、日志、参数预处理，也可以提前返回响应；after_request 在视图生成响应后运行，必须返回 response，常用于添加响应头；teardown_request 在请求上下文销毁时运行，无论是否异常都会执行，适合资源清理。

详细版

三者区别：

before_request：请求前置处理；返回非 None 会中断视图执行。
after_request：响应后置处理；接收 response，必须返回 response。
teardown_request：请求结束清理；接收异常对象，不用于修改响应。

示例：

@app.before_request
def load_user():
    ...

@app.after_request
def add_headers(response):
    response.headers["X-App"] = "demo"
    return response

@app.teardown_request
def close_db(exc):
    ...

它们适合处理横切逻辑，但不应该滥用来承载具体业务流程。

完整版教学

一、请求钩子解决什么问题

很多逻辑不是某个视图独有，而是大量请求都需要。例如记录请求日志、加载当前用户、校验 token、添加安全响应头、释放数据库连接。如果每个视图都重复写这些代码，会非常冗余。

Flask 请求钩子提供了在请求生命周期特定阶段插入逻辑的能力。它有点像轻量级中间件机制，但和 WSGI middleware 不完全一样：Flask 钩子发生在 Flask 应用内部，围绕视图函数运行；WSGI middleware 则包在整个 Flask 应用外层。

二、before_request：视图前的入口

before_request 在每次请求匹配到视图前执行：

@app.before_request
def authenticate():
    token = request.headers.get("Authorization")
    if not token:
        return {"error": "unauthorized"}, 401

如果返回了响应，Flask 不会继续执行视图函数。这适合做认证失败、限流失败、维护模式等提前拦截。

但不要把具体业务校验都放到全局 before_request。比如“下单时优惠券是否可用”只属于下单业务，不应该影响所有请求。全局钩子适合横切逻辑，业务逻辑应放在视图或服务层。

三、after_request：响应生成后的处理

after_request 接收视图生成的 response：

@app.after_request
def add_security_headers(response):
    response.headers["X-Content-Type-Options"] = "nosniff"
    return response

它适合统一添加 Header、处理 CORS、记录响应状态、包装部分响应信息。注意它必须返回 response，否则请求会出错。

如果视图抛出未处理异常，after_request 不一定按正常路径执行，具体行为取决于异常处理过程。因此必须执行的清理逻辑不要放在 after_request，而应该放在 teardown_request。

四、teardown_request：上下文销毁时清理

teardown_request 在请求上下文弹出时调用，常用于释放资源：

@app.teardown_request
def close_db(exc):
    db = g.pop("db", None)
    if db is not None:
        db.close()

它会收到异常对象 exc，如果请求正常结束，通常为 None；如果处理过程中出现异常，则可能是异常实例。

teardown 的定位是“善后”，不是“改响应”。它的返回值会被忽略。面试时这点很常考：after_request 用于修改响应，teardown_request 用于清理资源。

五、蓝图级钩子和全局钩子

Flask 支持 app 级钩子，也支持 blueprint 级钩子。全局钩子影响所有请求，蓝图钩子只影响该模块下的请求。

例如后台管理模块需要额外权限校验，可以放在 admin 蓝图的 before_request 中，而不是全局钩子里判断路径前缀。这样模块边界更清晰，也更容易测试。

当项目变大时，钩子的作用范围非常重要。全局钩子越多，请求链路越难理解；模块级钩子能把影响范围控制在局部。

六、和中间件的区别

Flask 里也可以使用 WSGI middleware，例如在应用外层包一层：

app.wsgi_app = SomeMiddleware(app.wsgi_app)

WSGI middleware 处理的是更底层的 WSGI 请求和响应，适合通用协议层能力，例如 ProxyFix、性能监控、请求 ID 注入等。Flask 钩子则更贴近 Flask 内部对象，可以直接访问 request、g、session。

面试时可以说：钩子是 Flask 内部生命周期扩展点，中间件是 WSGI 层包装。二者都能做横切逻辑，但层级和可访问对象不同。

七、常见错误

错误一：after_request 忘记返回 response。这个错误很直接，会导致 Flask 无法得到最终响应。

错误二：在 teardown_request 中依赖修改响应。teardown 阶段主要做清理，返回值不会作为响应使用。

错误三：全局钩子过重。每个请求都会经过全局钩子，如果里面做复杂数据库查询，会拖慢全站接口。

错误四：异常处理和资源清理混在一起。错误响应应该交给 errorhandler，资源释放交给 teardown。

八、常见误区与追问

机制	执行位置	适合做什么
`before_request`	视图前	认证、限流、参数预处理、提前拦截
`after_request`	响应生成后	加 Header、CORS、响应日志
`teardown_request`	上下文销毁时	释放资源、关闭连接、清理临时状态
WSGI middleware	Flask app 外层	协议层包装、代理头处理、监控埋点

误区：after_request 不需要返回 response。 它必须返回响应对象，否则 Flask 无法得到最终响应。
误区：teardown_request 适合改响应。 teardown 主要做清理，返回值不会作为响应使用，不应承担响应改写职责。
误区：Flask 钩子和 WSGI middleware 是同一层。 钩子运行在 Flask 生命周期内，可以方便访问 request/g/session；WSGI middleware 包在应用外层，处理更底层的 environ/response。
追问：before_request 直接返回响应会怎样？ Flask 会跳过视图函数，后续进入响应处理，适合认证失败、维护模式、限流拒绝等场景。
追问：蓝图级钩子有什么价值？ 它只影响对应蓝图，适合模块级权限和日志，避免全局钩子过重或误伤其他接口。
追问：为什么全局钩子要保持轻量？ 每个请求都会经过全局钩子，里面做大量 SQL 或远程调用会把全站接口一起拖慢。

记忆钩子：before 管“进视图前能不能过”，after 管“响应出去前补什么”，teardown 管“最后清什么”；middleware 在 Flask 外面包一层。

九、加强记忆

Flask 请求钩子可以按时间点记：before_request 在视图前，可拦截；after_request 在响应后，可改响应且必须返回 response；teardown_request 在上下文销毁时做清理，不用于改响应。全局钩子处理横切逻辑，模块逻辑优先考虑蓝图级钩子。

简化版

详细版