PHP中$_POST接收POST参数值全为空的问题排查

PHP中$_POST全局变量自动解析参数存在严格限制，仅当POST请求满足以下两个条件时才会正常填充参数：

• 请求方法为POST
• 请求头Content-Type为application/x-www-form-urlencoded（普通表单提交格式）或multipart/form-data（带文件上传的表单格式）

绝大多数测试时$_POST全为空的场景，都是因为接口测试工具里选了JSON格式传参，此时请求头Content-Type为application/json，PHP不会自动把JSON格式的请求体解析到$_POST数组中。
其他少见诱因包括：PHP配置关闭了POST自动解析、请求实际不是POST方法、web服务重写规则把POST请求转成了GET请求、代码提前读取了原始请求体导致$_POST未正常填充。

• 第一步：临时加全量调试代码定位问题
  在PHP文件最开头加入以下调试代码，先确认请求实际到达服务端的状态：

  // 输出请求方法
  echo "请求方法：";
  var_dump($_SERVER['REQUEST_METHOD']);
  echo "------------";
  // 输出请求头Content-Type
  echo "Content-Type：";
  var_dump($_SERVER['CONTENT_TYPE']);
  echo "------------";
  // 输出PHP自动解析的$_POST数组
  echo "解析到的POST数组：";
  var_dump($_POST);
  echo "------------";
  // 输出原始请求体内容
  echo "原始请求体：";
  var_dump(file_get_contents('php://input'));
  exit;
  

  根据输出结果对应处理：
  • 如果请求方法不是POST：回到Thunder插件配置，确认请求方法选的是POST，不是GET/其他方法。
  • 如果原始请求体能看到你填的参数内容，但$_POST数组为空：就是Content-Type不匹配导致的。
• 第二步：根据传参格式调整接参方式
  两种方案二选一即可：
  1. 调整测试工具的传参格式适配$_POST
     打开Thunder插件的Body配置栏，不要选JSON/XML类的传参格式，选择Form-encoded或者Form Data，在对应表单字段里填入你要传的参数名和值，再发请求即可正常通过$_POST取到值。
  2. 调整PHP代码适配JSON格式传参
     如果你需要用JSON格式传参（前后端分离接口的通用做法），不要用$_POST接参，改为手动解析原始请求体，参考代码：

     // 读取原始POST请求体
     $rawPost = file_get_contents('php://input');
     // 解析JSON为关联数组，加默认空数组避免解析失败报错
     $postParams = json_decode($rawPost, true) ?? [];
     // 从解析后的数组取参数，加默认值避免字段不存在时报错
     $nombre             = $postParams['nombre'] ?? '';
     $razon_social       = $postParams['razon_social'] ?? '';
     $apellido_paterno   = $postParams['apellido_paterno'] ?? '';
     $apellido_materno   = $postParams['apellido_materno'] ?? '';
     $rut                = $postParams['rut'] ?? '';
     $email              = $postParams['email'] ?? '';
     $telefono           = $postParams['telefono'] ?? '';
     $fecha_nacimiento   = $postParams['fecha_nacimiento'] ?? '';
     $comuna             = $postParams['comuna'] ?? '';
     $ciudad             = $postParams['ciudad'] ?? '';
     

• 第三步：排查配置问题
  如果上面两步处理完还是有问题，打开php.ini配置文件，确认enable_post_data_reading = On，这个配置如果设为Off，PHP会完全关闭POST请求体的自动解析，改完配置后重启你的web服务（Apache/Nginx/PHP内置开发服务器）即可生效。
  另外检查是否有前置代码提前读取了php://input，部分自定义逻辑或者框架中间件提前消费请求体后，也可能导致$_POST填充异常。

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