Laravel API响应异常：请求体追加至响应，状态码不符排查求助

问题现象 #

在Nginx+Docker生产环境调用Laravel API时出现以下异常：

• 前两次请求返回200状态码，响应内容为请求体内容与错误响应内容的拼接（示例如下）
  请求体：

  {
    "email": "user@example.com",
    "password": "string"
  }
  

  异常响应：

  {
    "email": "user@example.com",
    "password": "string"
  }{"message":"Invalid credentials"}
  

• 第三次请求才会正常返回401状态码及预期响应：

  {
    "message": "Invalid credentials"
  }
  

本地开发环境无此问题，重启Docker可临时解决，但问题会复现。

可能原因及排查修复方案 #

1. PHP-FPM长连接复用导致请求体残留 #

Nginx默认复用与PHP-FPM的连接，若之前请求的请求体未被PHP-FPM完全读取，会导致下一次请求时残留内容被追加到响应中，Docker环境的资源限制或连接池配置不当会加剧这个问题。

修复调整：
在Nginx的location ~ \.php$块中添加/调整以下配置，确保请求体被正确缓冲：

fastcgi_request_buffering on; # 默认开启，确保未被意外关闭
fastcgi_buffer_size 16k;
fastcgi_buffers 4 16k;

2. Nginx upstream长连接配置缺失 #

当前upstream未配置长连接参数，可能导致连接复用机制异常。

修复调整：
修改upstream块，添加长连接配置：

upstream backend {
    server web:9000;
    keepalive 32; # 维持32个长连接，可根据并发量调整
}

同时在location ~ \.php$块中添加：

fastcgi_keep_conn on;

该配置允许Nginx保持与PHP-FPM的长连接，避免频繁创建连接引发的状态混乱。

3. PHP-FPM进程状态异常 #

Docker容器内的PHP-FPM进程可能因内存泄漏、进程过载导致请求处理混乱。

排查步骤：

• 检查PHP-FPM配置（如php-fpm.conf或www.conf）中的pm.max_children、pm.start_servers等参数，确保符合容器资源限制
• 查看PHP-FPM日志（通常路径为/var/log/php-fpm/），排查是否存在进程崩溃、超时等错误记录

4. 辅助排查步骤 #

• 查看Nginx的error.log和access.log，定位异常请求的相关日志记录
• 临时将fastcgi_request_buffering设为off进行测试（仅用于排查，不建议长期使用），验证是否还会出现请求体残留
• 检查Laravel应用的自定义中间件，确认是否存在未正确清空请求输入的逻辑

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