PHP捕获JSON解析错误的方法

PHP解析JSON时默认不抛出异常，仅返回null，容易掩盖格式错误导致调试困难；本文详解了通过json_last_error()手动检测错误码、利用PHP 7.3+新增的JSON_THROW_ON_ERROR标志触发JsonException异常，以及封装兼顾新旧版本的健壮解析函数等实用方案，帮助开发者快速定位引号缺失、括号不匹配、UTF-8编码异常等常见问题，并提供清晰友好的错误提示，显著提升JSON处理的可靠性与开发效率。

PHP 中使用 json_decode() 解析 JSON 字符串时，如果内容存在语法错误（如引号不匹配、非法字符、格式错误等），函数不会抛出异常，而是返回 null。因此需要额外手段来检测和捕获这些错误。通过结合错误标志和封装处理逻辑，可以实现更友好的错误提示。

使用 json_last_error() 检查解析错误

PHP 提供了 json_last_error() 函数，用于获取最后一次 JSON 操作的错误状态。配合 json_decode() 使用，可判断是否解析成功：

示例代码：

function safeJsonDecode($jsonString) {
    $data = json_decode($jsonString, true);
    
    if (json_last_error() === JSON_ERROR_NONE) {
        return ['success' => true, 'data' => $data];
    }

    return [
        'success' => false,
        'error'   => json_last_error_msg(),
        'raw'     => $jsonString
    ];
}

添加 JSON_THROW_ON_ERROR 标志（PHP 7.3+）

从 PHP 7.3 开始，json_decode() 支持传入 JSON_THROW_ON_ERROR 标志，使函数在出错时抛出 JsonException 异常，便于用 try-catch 捕获：

try {
    $data = json_decode($jsonString, true, 512, JSON_THROW_ON_ERROR);
    echo "解析成功";
} catch (JsonException $e) {
    echo "JSON 解析失败: " . $e->getMessage();
}

封装通用解析函数返回友好提示

将上述方法整合，可创建一个健壮的 JSON 解析包装函数，兼顾兼容性和提示清晰度：

function parseJson($jsonString) {
    // 去除 BOM 或空白字符干扰
    $jsonString = trim($jsonString);
    if (substr($jsonString, 0, 3) === pack("CCC", 0xEF, 0xBB, 0xBF)) {
        $jsonString = substr($jsonString, 3);
    }

    if (PHP_VERSION_ID >= 70300) {
        try {
            $data = json_decode($jsonString, true, 512, JSON_THROW_ON_ERROR);
            return ['success' => true, 'data' => $data];
        } catch (JsonException $e) {
            return [
                'success' => false,
                'error'   => $e->getMessage(),
                'code'    => $e->getCode()
            ];
        }
    } else {
        $data = json_decode($jsonString, true);
        if (json_last_error() === JSON_ERROR_NONE) {
            return ['success' => true, 'data' => $data];
        }
        return [
            'success' => false,
            'error'   => json_last_error_msg(),
            'hint'    => '请检查 JSON 格式，如引号、逗号、括号是否正确'
        ];
    }
}

调用示例：

$result = parseJson('{"name": "张三", "age": }');
if (!$result['success']) {
    echo "错误提示：" . $result['error'];
}

基本上就这些。合理使用错误检测机制和异常处理，能让 JSON 解析更可靠，调试更高效。

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