Flask 用 before_request 钩子替代中间件,在每次请求前执行,可读取但不可修改只读的 request.headers;真正修改需存入 g 对象供视图使用,或在 WSGI 层通过 environ 注入头。

Flask 本身没有“中间件”概念,用 before_request 替代
Flask 不像 Django 或 Express 那样提供标准中间件链,它用 before_request 钩子函数实现类似功能。这个函数在每次请求进入视图前执行,适合读取、修改请求头——但要注意:你不能直接改 request.headers,因为它是只读的 Headers 对象。
常见错误现象:
– 写 request.headers['X-User-ID'] = '123' 报 TypeError: Headers object is immutable
– 试图在 before_request 中覆盖 request 全局变量,结果无效(request 是上下文局部对象,重新赋值不改变当前请求上下文)
- 真正能改请求头的方式是:把需要的数据存到
g(Flask 的请求上下文全局存储),然后在视图里用;或者用Werkzeug的底层机制包装请求,但代价高、不推荐 - 如果目标是“让下游视图逻辑看到修改后的头”,最稳妥做法是统一从
g取值,例如:g.user_id = request.headers.get('X-Forwarded-User') or request.headers.get('X-User-ID') - 若必须伪造整个请求对象(如测试或代理场景),可用
EnvironBuilder构造新environ,再调用Request(environ),但这已脱离常规before_request流程
用 WSGI 中间件拦截并修改原始 environ
想真正篡改传入 Flask 的请求头(比如加 X-Real-IP、删 Cookie),得在 WSGI 层动手——也就是在 Flask app 实例被调用前,用一个可调用对象包装它。这是唯一能修改原始 environ 字典的地方。
使用场景:
– 反向代理后修复客户端 IP
– 统一注入认证头供内部服务识别
– 日志/审计用途的请求头清洗
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- WSGI 中间件是一个接受
app、返回新 callable 的函数,签名必须是def __call__(self, environ, start_response) -
environ是字典,可直接增删改,例如:environ['HTTP_X_REAL_IP'] = environ.get('HTTP_X_FORWARDED_FOR', '').split(',')[0].strip() - 注意键名格式:所有请求头在
environ中都以HTTP_开头、大写、中划线变下划线,比如X-Auth-Token→HTTP_X_AUTH_TOKEN - 不要动
CONTENT_TYPE或CONTENT_LENGTH等核心键,否则可能导致request.get_data()失败
修改响应头?用 after_request 或 Response 对象
虽然问题问的是请求头,但实践中常连带需要改响应头(比如加 CORS、X-Frame-Options)。这时候别碰 before_request,要用 after_request 或直接返回 Response 实例。
-
after_request函数接收response对象,可安全调用response.headers['X-Processed'] = 'true' - 如果某个视图需要特殊响应头,优先用
make_response()包一层再设头,比全局after_request更精准 - 避免在
after_request里做耗时操作(如查 DB、发 HTTP 请求),它会阻塞整个响应流程 - 注意:若视图里用了
redirect()或abort(),它们返回的Response仍会经过after_request,所以逻辑要兼容各种响应类型
为什么不用 Flask-HTTPAuth 或其他扩展来“自动处理头”
像 Flask-HTTPAuth 这类扩展,本质还是读取 request.headers 做校验,并不修改它。它解决的是“怎么解析 Authorization 头”,不是“怎么注入或覆盖头”。如果你的需求是动态补全缺失头、降级 fallback、或根据路由规则重写头,这些扩展帮不上忙。
容易被忽略的点:
– 开发时用 flask run 启动,WSGI 中间件必须包在 app 外层,比如 app = MyMiddleware(app),而不是注册进 Flask 扩展机制
– 使用 Gunicorn / uWSGI 时,中间件要放在最外层,否则可能被服务器自带中间件绕过
– 修改 environ 后,Flask 的 request.remote_addr 等属性不会自动更新,需手动同步(比如设 environ['REMOTE_ADDR'] = new_ip)
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










