Laravel+Nginx环境下JSON响应被莫名追加内容致解析失败求助

问题概述 #

调用创建新用户的API时，客户端收到的响应被额外追加了一段JSON内容，导致整体JSON格式无效，API解析失败。追加的内容为：

{
"id": 2510744,
"status": "queued"
}

该问题仅出现在此创建用户的API中，其他需登录的API均正常。后端流程中，Laravel在中间件terminate方法前的响应是正确的，但客户端最终收到的响应被篡改。

已完成的排查 #

• 通过Laravel中间件terminate方法确认服务器响应正确，排除PHP、MySQL层面问题
• 检查应用日志、服务器日志未发现相关异常记录
• 排查php-fpm配置与日志，未发现异常
• 注释Nginx的ngx_http_image_filter_module、ngx_http_xslt_filter_module.so模块并重启，问题仍存在
• 在React应用及reqbin中调用该API均出现相同问题，排除客户端因素

进一步排查思路 #

1. 排查Nginx响应处理环节 #

• 配置Nginx记录完整响应内容：在对应location块中添加自定义日志格式包含响应体，示例配置：

  log_format response_log '$remote_addr - $remote_user [$time_local] '
                          '"$request" $status $body_bytes_sent '
                          '"$http_referer" "$http_user_agent" '
                          '"$request_body" "$response_body"';
  access_log /var/log/nginx/api_response.log response_log;
  

  注：$response_body需依赖第三方模块支持，若未安装可临时用tcpdump抓包，直接查看Nginx转发给客户端的原始响应内容。
• 检查该API对应的Nginx location配置：是否存在proxy_pass后的额外处理、sub_filter替换规则、add_header或其他响应修改指令，尤其是针对未登录请求的特殊配置。
• 排查Nginx是否启用了安全、监控类第三方模块，这类模块可能在响应阶段追加内容。

2. 排查Laravel后端的异步/事件逻辑 #

• 确认创建用户的逻辑中是否触发了队列任务：虽然terminate方法前响应正确，但队列任务或异步回调可能通过错误的输出（如echo、var_dump）向响应流写入内容。
• 检查创建用户相关的观察者、事件监听器：是否有代码在事件触发时直接输出内容，而非通过Laravel的响应对象返回。
• 排查全局/路由中间件：针对未登录请求的中间件是否在terminate之后有额外输出逻辑。

3. 排查服务器层面的其他服务 #

• 检查服务器上是否运行反向代理、WAF、负载均衡等服务：这些服务可能对未登录的创建用户请求进行响应修改或追加内容。
• 使用strace跟踪php-fpm或Nginx进程：查看进程的系统调用，是否有额外的写入操作到响应流中。示例命令：

  strace -p [目标进程ID] -e write
  

4. 排查响应传输细节 #

• 检查响应的Content-Length头部：Laravel返回的响应是否正确设置该字段，若未设置可能导致分块传输时出现额外内容。
• 临时禁用HTTP/2：若Nginx启用了HTTP/2，可能存在协议层面的响应拼接问题，禁用后测试是否恢复正常。

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