json_decode() 返回 null 不一定是格式错误，还可能是超深嵌套、输入为"null"字符串、空字符串、false、utf-8 bom 或编码问题；须用 json_last_error() 配合判断。
json_decode() 返回 null 就一定是格式错误？
不一定。PHP 的 json_decode() 在解析失败时返回 null，但这个 null 可能来自三种情况：JSON 语法错误、超深嵌套（默认 512 层）、或字符串本身是 "null"（合法 JSON）。别一看到 null 就断定是格式问题。
- 必须配合
json_last_error()和json_last_error_msg()判断真实原因 - 空字符串、
null、false输入也会让json_decode()返回null，但它们不是 JSON 格式错误 - 如果输入是 UTF-8 BOM 开头的字符串，
json_decode()会静默失败（返回null），需先用trim($json, "\xEF\xBB\xBF")清除
验证 JSON 字符串是否合法的最小可靠写法
不用封装函数，也不依赖扩展，只靠原生函数就能稳住。关键是把错误检查做进同一判断链里：
function is_valid_json(string $json): bool
{
if (!is_string($json) || $json === '') {
return false;
}
json_decode($json);
return json_last_error() === JSON_ERROR_NONE;
}
注意点：
-
json_decode()必须执行一次，否则json_last_error()返回的是上一次调用的残留状态 - 不要用
=== null做判断——因为json_decode('null')合法，也返回null - 不建议加
JSON_THROW_ON_ERROR（PHP 7.3+）用于验证场景，它会让错误中断流程，反而掩盖了“到底错在哪”
从文件读取 JSON 时容易漏掉的编码和换行问题
直接 file_get_contents() 读出来的内容，可能带 Windows 换行 \r\n、BOM、或 GBK 编码——这些都会让 json_decode() 失败，且报错信息全是 JSON_ERROR_SYNTAX，看不出根源。
立即学习“PHP免费学习笔记（深入）”；
- 务必用
mb_convert_encoding($content, 'UTF-8', 'auto')统一转码，'auto'能识别 GBK/GB2312/UTF-8 等常见编码 - 用
preg_replace('/\s*$/u', '', $content)去掉末尾空白（某些编辑器保存 JSON 会在末尾多加空格或换行） - 避免用
file()读取——它按行分割会破坏 JSON 结构；必须用file_get_contents()
大 JSON 或含中文字段时的性能与兼容性提醒
PHP 默认对 JSON 解析有深度限制（512 层）和大小限制（受内存配置影响），但更常踩坑的是中文处理：
- PHP 7.4+ 默认开启
JSON_INVALID_UTF8_IGNORE（可通过ini_set('json.decode_ignore_invalid_utf8', '1')控制），旧版本遇到非法 UTF-8 字节会直接失败，而不会跳过 - 含大量中文的 JSON，若原始数据是 GBK 编码却没转 UTF-8，
json_decode()不报具体位置，只报JSON_ERROR_UTF8 - 验证阶段不需要完整解码成数组，所以别用
json_decode($json, true)——加true参数会多一次数组转换，纯验证用false或省略即可
真正难的不是“怎么判”，而是当 json_last_error_msg() 返回 “Syntax error” 时，你得知道该去查 BOM、查换行、查编码、查是不是被前端悄悄加了注释——这些都不会出现在错误信息里。
