反向代理上下文透传应复用异步非阻塞机制，通过proxy_set_header注入内存变量、共享内存预加载元数据、流式header-only处理实现零干扰i/o；避免dns解析、子请求、磁盘io等同步操作。
在反向代理层透传上下文（如用户身份、请求追踪ID、设备信息等）且完全不干扰网络 I/O，关键不在于“加功能”，而在于**复用现有异步非阻塞机制的天然能力**——Nginx、Envoy、Traefik 等主流反向代理本身已是异步非阻塞架构，其请求处理生命周期中存在多个零拷贝、无调度开销的钩子点。只要避免同步阻塞操作（如 DNS 解析、本地磁盘读写、外部 HTTP 调用），上下文透传本身几乎不引入额外延迟。
利用 proxy_set_header 在请求头中注入上下文
这是最轻量、最符合异步非阻塞原则的方式。Nginx 的 proxy_set_header 指令在 request header 构建阶段执行，仅做字符串拼接或变量展开（如 $request_id、$http_x_user_id），全程内存操作，不触发任何系统调用或等待。
- 直接透传原始请求头：
proxy_set_header X-User-ID $http_x_user_id;（若客户端已携带） - 注入自动生成上下文：
proxy_set_header X-Request-ID $request_id;（Nginx 内置变量，无需额外模块） - 组合可信字段：
proxy_set_header X-Forwarded-For "$http_x_forwarded_for, $remote_addr";（注意：仅追加，不解析）
通过共享内存（shm）实现跨 worker 上下文关联
当需在代理层做轻量级上下文增强（如查白名单、打标、限流标识），又不能发起外部调用时，可将元数据预加载至 Nginx 共享内存区（via ngx_http_limit_req_module 或自定义 Lua shared dict）。Lua 模块（OpenResty）在此场景优势明显：
- 在
access_by_lua_block中从 shm 读取配置或映射表，毫秒级完成 - 用
ngx.var注入变量，后续proxy_set_header直接引用，无 IO 等待 - 所有操作在事件循环内完成，不创建协程、不 yield、不 sleep
使用流式 header-only 处理避免 body 缓冲
若上下文依赖请求体（如 JWT payload、签名摘要），必须确保不阻塞整个请求流。正确做法是：
- 启用
proxy_buffering off;，禁用响应体缓存 - 对 header-only 场景，用
proxy_pass_request_body off;+proxy_set_body ""，彻底跳过 body 读取 - 若真需解析 body，仅限小文本（如 JSON），用 Lua 的
ngx.req.read_body()+ngx.req.get_body_data()，并在rewrite_by_lua_block阶段完成，避免阻塞 downstream 连接
避免踩坑：这些操作会破坏非阻塞性
以下行为看似方便，实则引入同步等待，违背前提条件：
- 在配置中调用
resolver做动态域名解析（应预解析或用 IP） - 用
auth_request模块转发子请求到后端鉴权服务（本质是同步 HTTP 调用） - 在 Lua 中执行
os.execute、io.open或未设 timeout 的httpc:request() - 启用
proxy_store或proxy_cache_use_stale等涉及磁盘 I/O 的缓存策略
本质上，上下文透传不是“加逻辑”，而是“选变量、设头、传下去”。只要所有数据源来自内存（变量、header、shm）、所有操作在 Nginx 事件循环内完成、所有外部依赖被提前静态化，就能真正实现零干扰网络 I/O 的上下文透传。
