使用json_last_error()和JSON_THROW_ON_ERROR可检测JSON解析错误，结合封装函数返回友好提示，提升调试效率。
PHP 中使用 json_decode() 解析 JSON 字符串时，如果内容存在语法错误（如引号不匹配、非法字符、格式错误等），函数不会抛出异常，而是返回 null。因此需要额外手段来检测和捕获这些错误。通过结合错误标志和封装处理逻辑，可以实现更友好的错误提示。
使用 json_last_error() 检查解析错误
PHP 提供了 json_last_error() 函数，用于获取最后一次 JSON 操作的错误状态。配合 json_decode() 使用，可判断是否解析成功：
- JSON_ERROR_NONE：无错误
- JSON_ERROR_DEPTH：超过最大堆栈深度
- JSON_ERROR_STATE_MISMATCH：语法错误，如括号不匹配
- JSON_ERROR_CTRL_CHAR：控制字符错误
- JSON_ERROR_SYNTAX：语法错误
- JSON_ERROR_UTF8：UTF-8 编码错误
示例代码：
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 捕获：
立即学习“PHP免费学习笔记（深入）”；
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 解析更可靠，调试更高效。
