PHP处理JSON错误的正确方法

PHP处理JSON时，json_decode()默认静默失败返回null，极易掩盖真实错误，正确做法是结合json_last_error_msg()精准定位问题，或在PHP 7.3+中启用throw_on_error参数让解析失败自动抛出JsonException，从而避免因空字符串、语法错误或中间调用干扰导致的误判，大幅提升调试效率与代码健壮性。

json_decode() 返回 null 却没报错？先检查 json_last_error()

PHP 的 json_decode() 默认失败不抛异常，只静默返回 null。你看到 null，不等于 JSON 格式错误——也可能是原始字符串为空、是布尔值 false、或被 trim 过的空白字符串。

真正判断是否出错，必须配合 json_last_error() 或更推荐的 json_last_error_msg()：

$json = '{ "name": "张三", "age": }';
$data = json_decode($json, true);
if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
    echo '解析失败：' . json_last_error_msg(); // 输出：Syntax error
}

• json_last_error() 返回整数错误码，需手动比对（如 JSON_ERROR_SYNTAX）
• json_last_error_msg() 直接返回可读字符串，开发期调试更省事
• 注意：每次调用 json_decode() 后，json_last_error() 才会被更新；中间若调用了其他 JSON 函数（如 json_encode()），会覆盖上一次状态

想让 json_decode() 主动抛异常？用 throw_on_error 参数（PHP 7.3+）

PHP 7.3 起，json_decode() 新增第 3 个参数 throw_on_error，设为 true 后，解析失败直接抛出 JsonException，不用手动查错误码。

try {
    $data = json_decode($badJson, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    error_log('JSON 解析异常：' . $e->getMessage());
}

• 必须显式传入第 4 个参数 JSON_THROW_ON_ERROR，仅设 throw_on_error => true 不生效
• 该标志只影响本次调用，不影响全局行为
• 低版本 PHP（Unknown named parameter $throw_on_error

json_encode() 失败返回 false？常见原因和绕过方式

json_encode() 失败时返回 false，但不像 json_decode() 提供错误查询接口——它没有 json_last_error() 对应机制。失败通常因为数据含不可序列化内容：

• 资源类型（如 mysqli 句柄、文件指针）
• 包含循环引用的对象（对象 A → B → A）
• 非 UTF-8 编码字符串（尤其从数据库或旧系统读取时）
• 浮点数为 INF 或 NAN（PHP 7.0+ 默认拒绝）

应对建议：

// 检查编码（简单粗暴）
$utf8_str = mb_convert_encoding($str, 'UTF-8', 'auto');

// 过滤非法浮点数（PHP 7.0+）
if (is_float($val) && !is_finite($val)) {
    $val = null;
}

// 对象序列化前先清理（避免循环引用）
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PARTIAL_OUTPUT_ON_ERROR);

• JSON_PARTIAL_OUTPUT_ON_ERROR（PHP 7.1+）能让部分字段失败时不整体崩掉，用 null 替代问题值
• 别依赖 json_last_error() 查 json_encode() 错误——它不记录 encode 失败
• 生产环境建议加 is_string($result) && $result !== '' 双重校验返回值

用 json_validate() 提前过滤（PHP 8.0+）

PHP 8.0 加了 json_validate()，专用于「只校验不解析」，开销比 json_decode() 小得多，适合高频入参预检。

if (!json_validate($input)) {
    throw new InvalidArgumentException('非法 JSON 格式');
}
// 确保安全后再 decode
$data = json_decode($input, true);

• 它不解析结构，只做语法扫描，性能高、无副作用
• 不能替代 json_decode() 的类型转换逻辑（比如不会把 "123" 转成整数）
• 仍需注意：空字符串 ''、null、false 都返回 false，但它们本身不是 JSON —— 所以校验前最好先 is_string($input) && trim($input) !== ''

复杂点在于：不同 PHP 版本能用的工具完全不同，而错误表现又高度相似（都是 null 或 false）。别只看返回值，得盯住 PHP 版本、输入来源、以及是否中途调用了其他 JSON 函数干扰了错误状态。

理论要掌握，实操不能落！以上关于《PHP处理JSON错误的正确方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！