请求生命周期
请求生命周期
Section titled “请求生命周期”本页描述源码级请求路径。用户可见行为属于使用 ProxAI，协议行为属于协议指南。
- 1
inbound_request模块src/ingress/src/pipeline/inbound.rs职责检测请求路径，读取 body，解析协议 payload，并规范化入站请求元数据。
- 2routing模块
src/routing/src/config.rs职责解析显式路由或协议感知默认 provider；执行 request_protocol guard。
- 3
provider_request模块src/provider/*/requestsrc/translation/职责协议不同时转换 payload，重写 provider model，并序列化上游请求。
- 4provider transport模块
src/provider/*/transport职责构造上游 URL，附加 provider-owned 认证头，并通过 HTTP 发送。
- 5
upstream_response模块src/upstream/src/provider/*/response职责读取状态、headers、非流式 body 或流式 byte carrier。
- 6
outbound_response模块src/translation/src/http_support/职责把 provider response 转回入站协议，并重建客户端 HTTP response。
| 不变量 | 原因 |
|---|---|
Translation 不拥有 HTTP Response | translation layer 应该在 carrier 边界保持纯粹。 |
| Provider 认证来自 provider config | 客户端传入的 Authorization 不控制上游 provider 认证。 |
| 路由匹配错误必须显式 | 协议 guard mismatch 不应该落回另一个 provider。 |
| 流式完成是语义事件 | 完成需要协议终止事件，而不是仅仅 socket 关闭。 |