Docker Swarm环境下大体积HTTP JSON响应被截断故障排查

故障现象 #

在Docker Swarm集群栈中部署PHP Laravel后端及配套服务（含反向代理）时出现异常：部分返回大体积响应的GET请求返回被截断的JSON数据，具体表现为响应末尾缺失4-5个形如xx"}]的字符，直接导致前端JSON响应解析失败。

基础环境信息 #

• 系统架构：反向代理容器、Web容器均使用httpd作为服务端，代理负责将请求转发至后端Web容器
  
• Docker版本：

Docker version 20.10.11, build dea9396

• Laravel框架版本：

Laravel Framework 9.15.0

• 配套配置：已留存代理节点httpd.conf、Web节点httpd.conf、Web节点php.ini三份配置文件用于排查

现有观测结论 #

全链路tcpdump抓包结果 #

• 离开Web容器的响应数据包：内容完整无异常
• 进入代理容器的响应数据包：内容完整无异常
• 离开代理容器的响应数据包：已出现截断特征

已尝试排查操作 #

• 绕过代理直接访问Web容器：tcpdump显示Web容器发出的响应完整，但客户端接收端拿到的响应仍存在截断问题
• 全栈重启：包括删除所有容器、镜像后重新构建部署，故障仍未解决

可能成因与对应排查修复方案 #

1. httpd服务配置异常 #

这是双层httpd架构下响应截断的最高频诱因：

• 核心成因：httpd的反向代理缓冲、输出缓冲、响应大小限制、缓冲区参数配置不合理时，会在处理大体积响应时提前终止输出，导致尾部字符丢失。
• 排查修复步骤：
  • 分别在代理节点、Web节点的httpd配置中临时关闭缓冲与压缩测试：添加SetEnv no-gzip 1、SetEnv no-buffer 1全局配置，代理节点的反向代理规则添加nocanon disablereuse=On参数，关闭代理缓冲，验证响应是否恢复完整。
  • 检查httpd的SendBufferSize配置，将其设置为0使用系统默认缓冲区大小，避免人为设置的缓冲区过小截断响应。
  • 检查httpd的LimitResponseBody配置，确认未设置过小的响应体阈值，避免大响应触发限制被强制截断。
  • 检查httpd的Timeout、ProxyTimeout配置，确认大体积响应的传输时长不会触发超时规则，导致连接提前断开、尾部数据未发送完成。

2. PHP与Laravel输出层逻辑异常 #

• 核心成因：PHP输出缓冲、压缩配置错误，或Laravel响应发送逻辑提前终止，会导致响应未完全输出即关闭连接；注意容器网卡层抓包显示完整不代表应用层发送逻辑正常，需排除抓包点位与应用发送缓冲区的观测差。
• 排查修复步骤：
  • 检查php.ini中output_buffering配置，将其设置为Off或显式配置为40960以上的足够大值，避免PHP层缓冲提前刷新截断内容。
  • 临时关闭php.ini中zlib.output_compression压缩配置，排除压缩长度计算错误导致的尾部截断。
  • 在Laravel响应发送后置逻辑、public/index.php末尾添加长度校验日志，对比框架生成的原始JSON字符串长度、实际发送的响应字节数是否一致，排除框架层面提前终止输出的问题。
  • 检查PHP-FPM的request_terminate_timeout配置，确认大响应处理时长不会触发FPM超时终止进程。

3. Docker Swarm Overlay网络异常 #

当前使用的Docker 20.10.11版本存在多个已知的Overlay网络转发bug，且绕过代理直连仍出问题的特征高度匹配网络层故障：

• 核心成因：Overlay网络MTU配置不匹配、VXLAN封装分片丢失，会导致大体积响应的尾部分片报文在转发过程中被丢弃，表现为响应末尾固定缺失若干字符。
• 排查修复步骤：
  • 对齐全链路MTU配置：物理网卡默认MTU为1500时，Docker docker0网桥、自定义Overlay网络的MTU需设置为1450（预留50字节给VXLAN封装头），避免分片被丢弃。
  • 临时启动host网络模式的测试容器，直接访问Web服务端口请求大体积接口，如果host网络下响应完整，即可确认是Overlay网络MTU/分片转发问题。
  • 将Docker版本升级到20.10.18及以上的稳定版本，修复已知的Overlay网络分片丢包bug。

4. Content-Length响应头计算错误 #

• 核心成因：httpd、PHP、Laravel任意一层错误计算响应长度，在Content-Length头中标注的长度比实际响应体短，客户端会按照头标注的长度读取内容，直接丢弃尾部多余字节，表现为末尾固定缺失若干字符。
• 排查修复步骤：
  • 抓取正常场景下的完整响应，对比响应头中Content-Length的数值和实际JSON响应的字节长度，如果存在差值，逐层移除响应头修改规则、header模块自定义配置，定位是哪一层错误修改了长度值。
  • 临时配置httpd开启分块传输编码（ChunkedEncoding On）替代固定Content-Length，验证故障是否消失。

内容的提问来源于stack exchange，提问作者HmanA6399