Apache中ProxyPass处理大报文的核心是避免缓冲、控制边界、流式直通：需禁用ProxyBuffering、启用flushpackets=on和nocanon，调大ProxyReceiveBufferSize与LimitRequestBody，设ProxyTimeout 300并启用keepalive，优先选用mod_proxy_fcgi或mod_proxy_ajp等更适配协议。

apache 中 proxypass 处理大报文传输，核心不是“加大缓冲”，而是**避免缓冲、控制边界、流式直通**。默认行为会把整个 post 请求体或大响应体缓存完再转发，极易触发内存溢出（oom）、502 错误、首字节延迟飙升，尤其在文件上传、批量导入、流媒体等场景下。

禁用代理缓冲，启用流式转发

这是最关键的一步。mod_proxy_http 默认会完整缓存请求体和响应体，必须主动绕过：

• 对响应：直接关闭缓冲 ProxyBuffering off，让数据边收边发；若必须缓冲，严格限制规模，例如 ProxyBuffers 8 64k（总上限 512KB）并设 ProxyMaxTempFileSize 0 禁用磁盘暂存
• 对请求：在 ProxyPass 指令中加 flushpackets=on flushwait=1000，强制分块推送，减少单次滞留
• 禁用 Content-Length 重写：在 ProxyPass 后添加 nocanon 标志，防止 Apache 强制解析并覆盖原始流式头

放宽接收与传输的硬性限制

Apache 自身有两层“门禁”，必须按业务需求调宽：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• ProxyReceiveBufferSize 2097152（2MB）：提升 mod_proxy 内部读取请求体的缓冲区，避免截断
• LimitRequestBody 104857600（100MB）：设为业务允许的最大上传体积，超限直接返回 413，不进缓冲队列
• 注意：ClientMaxBodySize 是 Nginx 指令，Apache 不识别，混用会导致配置失效

延长超时并保持连接稳定性

大报文传输耗时长，超时错配是 502/504 的主因，需端到端对齐：

• 设全局代理生命周期上限：ProxyTimeout 300（5 分钟）
• 后端连接池启用 keepalive：ProxySet keepalive=on keepalive_timeout=5 max=50，复用 TCP 连接
• 前端连接也需配合：KeepAliveTimeout 60、TimeOut 300，确保握手、传输、空闲各阶段不被误断
• 后端（如 Tomcat/Nginx）的 connectionTimeout 和 keepAliveTimeout 必须 ≥ Apache 对应值，否则连接提前关闭

选用更匹配的协议模块

mod_proxy_http 不是万能底座，大报文场景下换协议往往更高效：

• 后端是 FastCGI（如 PHP-FPM）：改用 mod_proxy_fcgi，原生支持流式 body 转发，可配 flushpackets=on
• 后端是 Tomcat：优先用 mod_proxy_ajp，AJP 协议无 chunked 解析开销，天然适配大请求体
• 后端是 Unix socket：直接写 unix:/path/to.sock|http://localhost/，绕过网络栈，降低延迟和内存压力