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() 对应机制。失败通常因为数据含不可序列化内容：
立即学习“PHP免费学习笔记（深入）”；
- 资源类型（如
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) !== ''
null 或 false）。别只看返回值，得盯住 PHP 版本、输入来源、以及是否中途调用了其他 JSON 函数干扰了错误状态。 
