json_decode() 解析失败返回 null 怎么办

绝大多数时候不是 JSON 格式错了，而是编码或 BOM 头干扰了 json_decode() 的解析。PHP 对 UTF-8 BOM 非常敏感，哪怕字符串开头多了 ，json_decode() 就直接返回 null，且不报错。

• 先用 trim($json, "..") 或 mb_convert_encoding($json, 'UTF-8', 'UTF-8') 清理隐形字符
• 检查是否含 Windows 换行符 —— 虽然通常不影响，但和某些前端拼接逻辑混用时可能触发边缘 case
• 用 json_last_error() 和 json_last_error_msg() 真实查错，别只看返回值是不是 null
• 如果源数据来自 file_get_contents()，加个 mb_detect_encoding() 确认实际编码，别信文件后缀

php 字符串转数组：关联数组还是索引数组？

json_decode() 默认返回对象（stdClass），不是数组。想转成 PHP 数组，必须显式传 true 作为第二个参数 —— 这是新手最常漏掉的一点。

• json_decode($json) → 返回对象，访问用 ->key
• json_decode($json, true) → 返回关联数组，访问用 ['key']
• 嵌套结构里，true 会递归转所有层级为数组，包括空对象 {} 变成 []，这点和 JS 不同
• 如果 JSON 里有数字键（如 {"0":"a","1":"b"}），true 模式下仍生成关联数组，不会自动变成数字索引数组

中文乱码、特殊字符解析异常

PHP 7.4+ 默认支持 UTF-8，但前提是输入字符串本身是合法 UTF-8。常见陷阱是 GBK/GB2312 编码的 JSON 字符串直接丢给 json_decode()，结果部分字段消失或解析中断。

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• 用 mb_check_encoding($json, 'UTF-8') 先校验，不通过就用 mb_convert_encoding($json, 'UTF-8', 'GBK') 转换
• 注意 json_decode() 不处理 HTML 实体（如 "），前端若用了 JSON.stringify() 再经 HTML 输出，得先 html_entity_decode()
• 反斜杠转义没处理干净也会出问题：JSON 中的 "path\\file" 在 PHP 字符串里要写成 "path\\\\file" 才能正确传递给 json_decode()

性能与大 JSON 字符串注意事项

json_decode() 是 C 实现，本身很快，但大 JSON（>1MB）容易触发内存限制或解析超时，尤其在低配环境。

立即学习“PHP免费学习笔记（深入）”；

• 默认最大嵌套深度是 512，超深结构会报 JSON_ERROR_DEPTH，可用第三个参数指定深度，如 json_decode($json, true, 1024)
• 超大 JSON 不建议一次性 json_decode()，可考虑流式解析库（如 jsonstream），但 PHP 原生不支持
• json_decode() 不做类型校验，如果 JSON 里混了 "123"（字符串）和 123（数字），PHP 数组里就是两种类型并存，后续 is_int() 判断要小心
• 频繁解析相同结构 JSON？考虑用 opcache 加速，但注意 opcache 不缓存 json_decode() 结果，只能缓存脚本本身

解析 JSON 看似简单，真正卡住人的往往不是函数怎么调，而是字符串从哪来、中间经过了几道编码转换、有没有被其他函数悄悄改过内容。尤其是从 curl、file、数据库读出来的 JSON，务必先 dump 出原始字节再动手 decode。