Postman与自研应用POST请求结果不一致的原因排查及PHP后端适配问题

这问题其实很好理解，核心就是你的应用和Postman发送的POST请求，用了完全不同的Content-Type格式，而PHP对不同格式的POST数据，解析逻辑是不一样的。咱们一步步拆解：

1. 最初代码的工作逻辑（适配JSON请求） #

你最开始的代码用了file_get_contents("php://input")读取原始请求体，再用json_decode解析成数组——这是专门处理JSON格式POST请求的写法：

• 你的应用自身的HTTP请求，肯定是把数据序列化成了JSON字符串，并且设置了Content-Type: application/json请求头。
• PHP默认只会自动解析application/x-www-form-urlencoded（普通表单）或multipart/form-data（文件上传）类型的POST数据到$_POST数组里。对于JSON格式的请求，$_POST是空的，必须手动读取php://input的原始内容再解析。

2. 修改后代码的工作逻辑（适配表单请求） #

改成直接用$_POST的代码，是PHP处理常规表单请求的默认方式：

• 你用Postman测试时，默认应该是选择了form-data或者x-www-form-urlencoded格式，Postman会自动把请求头设为对应的Content-Type，这时候PHP会自动把请求体解析到$_POST里，所以代码能正常工作。
• 但你的应用还是发送JSON格式的请求，$_POST自然是空的，所以取不到数据就报错了。

解决方案：对齐请求格式，或者兼容两种格式 #

方案一：让Postman和应用用同一种格式（推荐） #

在Postman里切换到raw选项，选择JSON格式，然后在Headers里确保设置了Content-Type: application/json，再把请求数据写成JSON字符串，这样用你最初的代码就能正常接收数据了。

方案二：修改后端代码，同时兼容两种格式 #

如果需要同时支持JSON和普通表单请求，可以给代码加一个Content-Type判断：

public function post(String $key = '') {
    // 获取请求的Content-Type
    $contentType = $_SERVER['CONTENT_TYPE'] ?? '';
    
    // 判断是否为JSON格式请求
    if (str_contains($contentType, 'application/json')) {
        $rawData = file_get_contents("php://input");
        $requestData = json_decode($rawData, true) ?: [];
    } else {
        // 处理普通表单格式的请求
        $requestData = $_POST;
    }

    if (!empty($key)) {
        return isset($requestData[$key]) ? $this->clean($requestData[$key]) : null;
    }
    return $this->clean($requestData);
}

这样不管是应用发的JSON请求，还是Postman发的表单请求，都能正常处理了。

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