PHP json_decode解析失败是为什么_PHPJSON解析错误排查与修复【说明】

17次阅读

json_decode()返回NULL的五大原因及修复步骤:一、检查json语法合法性并用json_last_Error()定位错误;二、验证并转换为UTF-8编码,清除bom;三、确认字符串未被截断;四、移除不可见控制字符;五、禁用@错误抑制符。

PHP json_decode解析失败是为什么_PHPJSON解析错误排查与修复【说明】

如果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, “xEFxBBxBF”)清除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控制字符(如、t、n、r),但部分编辑器或API响应可能混入此类字符,导致解析失败。

1、使用preg_replace(‘/[x00-x08x0Bx0Cx0E-x1Fx7F]/’, ”, $json)移除所有ASCII控制字符。

2、使用json_encode(json_decode($json, true), JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)对原始字符串做“解析再序列化”验证,若该操作成功则说明原字符串含非法字符。

3、重点检查键名或字符串值中是否包含U+2028 LINE SEPARATORU+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)确保错误可见。

text=ZqhQzanResources