json_decode()返回null的五大原因及修复步骤：一、检查JSON语法合法性并用json_last_error()定位错误；二、验证并转换为UTF-8编码，清除BOM；三、确认字符串未被截断；四、移除不可见控制字符；五、禁用@错误抑制符。
如果PHP中调用json_decode()函数返回null，且未启用JSON_ERROR_NONE错误检查，则可能是由于输入字符串不符合JSON语法规范或编码异常。以下是排查与修复此问题的具体步骤：
一、检查JSON字符串是否为合法格式
json_decode()仅接受严格符合RFC 7159标准的UTF-8编码JSON字符串，任何语法错误（如尾随逗号、单引号、未转义字符）都会导致解析失败并静默返回null。
1、使用json_last_error()和json_last_error_msg()获取最近一次解析的错误类型与描述。
2、将待解析字符串赋值给变量后，立即调用json_last_error()判断是否为JSON_ERROR_NONE。
立即学习“PHP免费学习笔记（深入）”；
3、若非JSON_ERROR_NONE，用var_dump(json_last_error_msg())输出具体错误信息，例如"Syntax error"或"Control character error, possibly incorrectly encoded"。
二、验证字符串编码是否为UTF-8
json_decode()要求输入必须是UTF-8编码，若字符串含GB2312、GBK或BOM头等非UTF-8内容，解析将失败且不报明确异常。
1、使用mb_detect_encoding($json, ['UTF-8', 'GBK', 'BIG5'], true)检测原始编码。
2、若检测结果非UTF-8，使用mb_convert_encoding($json, 'UTF-8', $detected_encoding)转换编码。
3、若字符串开头存在BOM（如EF BB BF），用ltrim($json, "\xEF\xBB\xBF")清除UTF-8 BOM。
三、检查JSON字符串是否被意外修改或截断
从HTTP请求、文件读取或数据库查询获取的JSON数据可能因传输中断、SQL字段长度限制或输出缓冲截断而丢失末尾括号或引号，造成结构不完整。
1、使用strlen($json)与预期长度比对，确认无明显截断迹象。
2、用substr($json, -10)查看结尾字符，确认是否以"}"或"]"结束。
3、若来源为curl响应，检查curl_getinfo($ch, CURLINFO_HTTP_CODE)是否为200，并确认Content-Length与实际响应体长度一致。
四、排除不可见控制字符干扰
JSON标准禁止在字符串值中直接出现ASCII控制字符（如\0、\t、\n、\r），但部分编辑器或API响应可能混入此类字符，导致解析失败。
1、使用preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/', '', $json)移除所有ASCII控制字符。
2、使用json_encode(json_decode($json, true), JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)对原始字符串做“解析再序列化”验证，若该操作成功则说明原字符串含非法字符。
3、重点检查键名或字符串值中是否包含U+2028 LINE SEPARATOR或U+2029 PARAGRAPH SEPARATOR等Unicode控制符。
五、验证是否启用了错误抑制符@
在json_decode()前误加@符号会屏蔽所有PHP警告与Notice，导致无法通过错误报告机制发现根本原因，仅观察到返回null。
1、全局搜索代码中是否存在@json_decode(字样。
2、删除所有@前缀，确保错误可被error_reporting(E_ALL)捕获。
3、在调用前添加ini_set('display_errors', '1')与error_reporting(E_ALL)确保错误可见。
