php 接收 json 数据为空，核心原因是 $_post 无法解析非表单编码的请求体。当客户端发送 content-type: application/json 时，php 默认不会将请求体填充到 $_post 数组中，导致该数组为空。解决方向是绕过 $_post，直接读取原始输入流 php://input，并将其解码为 php 数组或对象。此方案适用于所有通过 post 方法发送 json 数据的场景，包括 api 接口调用、前端框架（如 vue/react）的 ajax 请求等。
数据流向与结构映射
理解数据如何从客户端到达服务器是解决问题的第一步。JSON 数据在 HTTP 请求体中以字符串形式存在，PHP 需要将其转换为内部数据结构。下图展示了请求头、请求体以及 PHP 内部处理后的数据层级关系，明确了根节点与子节点的对应关系。
<?php
// 1. 获取原始 JSON 字符串
$jsonString = file_get_contents('php://input');
// 2. 检查是否为空
if (empty($jsonString)) {
http_response_code(400);
echo json_encode(['error' => 'Empty input']);
exit;
}
// 3. 解码 JSON 为关联数组
$data = json_decode($jsonString, true);
// 4. 验证解码结果
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
echo json_encode(['error' => 'Invalid JSON', 'details' => json_last_error_msg()]);
exit;
}
// 5. 业务逻辑处理示例
if (isset($data['user_id']) && isset($data['action'])) {
$userId = intval($data['user_id']);
$action = $data['action'];
// 模拟成功响应
echo json_encode([
'status' => 'success',
'received' => [
'user_id' => $userId,
'action' => $action
]
]);
} else {
http_response_code(400);
echo json_encode(['error' => 'Missing required fields']);
}
?>
上述代码首先通过 file_get_contents('php://input') 读取请求体，这是处理 JSON 数据的关键步骤。接着使用 json_decode 并传入 true 参数，确保返回的是关联数组而非对象，便于后续使用键名访问。如果 JSON 格式错误，json_last_error() 会返回非零值，此时应返回 400 错误码及具体错误信息。成功解码后，代码检查必要字段是否存在，并返回结构化响应。这种处理方式避免了 $_POST 的限制，确保了数据的完整接收。
立即学习“PHP免费学习笔记（深入）”；
常见陷阱与边界处理
在实际开发中，仅读取输入流并不足够，还需处理多种边界情况。例如，重复消费输入流会导致后续读取为空，或者在处理大型 JSON 时遇到内存限制。此外，必须区分“空字符串”和“null”值，前者可能表示未发送数据，后者可能是合法的 JSON 值。下图展示了不同输入场景下的处理分支逻辑，强调了错误处理和数据验证的重要性。
<?php
// 模拟更健壮的处理流程
function handleJsonRequest() {
// 防止重复读取 php://input
static $parsedData = null;
if ($parsedData !== null) {
return $parsedData;
}
$rawInput = file_get_contents('php://input');
// 处理空输入
if ($rawInput === '' || $rawInput === null) {
return ['error' => 'No data received'];
}
// 尝试解码
$decoded = json_decode($rawInput, true);
// 检查 JSON 语法错误
if (json_last_error() !== JSON_ERROR_NONE) {
return ['error' => 'JSON parse error: ' . json_last_error_msg()];
}
// 检查解码结果是否为 null (例如输入为 "null" 字符串)
if ($decoded === null && $rawInput !== 'null') {
return ['error' => 'Decoded to null unexpectedly'];
}
$parsedData = $decoded;
return $parsedData;
}
// 调用示例
$result = handleJsonRequest();
if (isset($result['error'])) {
http_response_code(400);
echo json_encode($result);
} else {
// 处理有效数据
echo json_encode(['message' => 'Data processed', 'data' => $result]);
}
?>
这段代码引入了静态变量来缓存解析结果，避免多次调用 file_get_contents('php://input') 导致的问题。它特别处理了输入为空、JSON 语法错误以及解码结果为 null 但原始输入不为 "null" 字符串的情况。这些边界条件的处理能显著减少因数据格式问题导致的运行时错误。通过封装成函数，可以在多个入口点复用此逻辑，保持代码整洁。
验证方法与调试技巧
验证 JSON 数据是否正确接收，最直接的方法是使用 cURL 或 Postman 发送测试请求，并观察 PHP 返回的响应。在本地调试时，可以将 $rawInput 写入日志文件，以便查看原始数据内容。同时，检查服务器的 php.ini 配置，确保 allow_url_fopen 开启（虽然对 php://input 影响不大，但有助于其他功能），并监控 max_input_vars 和 memory_limit 是否限制了大数据包的接收。如果数据依然为空，需检查 Web 服务器（如 Nginx/Apache）的配置，确认是否拦截了特定 Content-Type 的请求，或请求体大小是否超过服务器限制。
