PHP 中 JSON 解析失败的五大排查方法：一、用 json_decode()配合 json_last_error()检测错误；二、预校验 JSON 合法性再解析；三、构造标准测试用例集批量验证；四、检查字符编码一致性；五、利用在线工具与命令行辅助验证。
如果您在 PHP 中处理 JSON 数据时遇到解析失败、返回 null 或产生警告，可能是由于 JSON 格式不合法、编码 问题或函数使用不当。以下是验证和测试 JSON 解析是否正常工作的多种方法：
一、使用 json_decode() 配合 json_last_error() 检测错误
该方法通过解析后调用 json_last_error()获取最近一次 JSON 操作的错误码，从而定位具体问题类型。它不依赖外部 工具，适合快速嵌入现有脚本中进行调试。
1、定义一个包含待测 JSON 字符串的变量，例如：$json = ‘{“name”:” 张三 ”,”age”:25}’;
2、调用 json_decode($json, true) 尝试解析为关联数组。
立即学习“PHP 免费学习笔记（深入）”；
3、立即执行 var_dump(json_last_error()); 查看返回值，如为 0 表示成功，非 0 则对应特定错误（如 JSON_ERROR_SYNTAX 表示语法错误）。
4、进一步使用 json_last_error_msg() 获取可读的错误描述字符串。
二、预校验 JSON 字符串合法性再解析
在调用 json_decode()之前，先判断输入字符串是否符合 JSON 语法结构，避免因非法输入导致静默失败或意外行为。此方式适用于接收用户提交或 API 响应等不可信来源的数据。
1、使用 filter_var($json, FILTER_VALIDATE_REGEXP, [‘options’ => [‘regexp’ => ‘/^\s*\{.*\}\s*$|^\s*\[.*\]\s*$/’]]) 做初步结构匹配（注意：仅作轻量级前置过滤，不能替代完整解析）。
2、将字符串传入json_decode($json, null, 512, JSON_THROW_ON_ERROR)，启用异常模式，使错误直接抛出 Exception 而非返回 null。
3、用 try-catch 包裹解析过程，捕获 JsonException 并输出详细信息。
三、构造标准测试用例集批量验证
通过预设多组典型 JSON 样本（包括正确、缺失引号、中文乱码、深度嵌套、超长数值等），系统性覆盖常见解析边界场景。该方式适合集成进单元测试框架或 CI 流程中。
1、准备一个数组，键为用例名称，值为待测 JSON 字符串，例如：$testCases = [‘valid’ => ‘{“id”:1}’, ‘missing_quote’ => ‘{“name”:abc}’];
2、遍历该数组，对每个字符串执行 json_decode($case, true) 并记录返回结果与 json_last_error() 值。
3、将结果写入临时文件或内存表格，比对预期状态（如 valid 应返回数组且错误码为 0，missing_quote 应返回 null 且错误码为 JSON_ERROR_SYNTAX）。
4、使用 assert(is_array($result) === $expectedIsArray) 进行断言判断，触发失败时中断执行并输出当前用例名。
四、检查字符编码一致性
JSON 规范要求 UTF- 8 编码，若原始字符串含 GB2312、GBK 或 BOM 头等非 UTF- 8 内容，json_decode()会直接返回 null 且错误码为 JSON_ERROR_UTF8。此步骤专用于排查中文相关解析异常。
1、使用 mb_detect_encoding($json, [‘UTF-8’, ‘GB2312’, ‘GBK’], true) 探测实际编码。
2、若检测结果不是 UTF-8，则用 mb_convert_encoding($json, ‘UTF-8’, $detectedEncoding) 转换编码。
3、检查字符串开头是否存在 BOM 头，使用 hexdec(bin2hex(substr($json, 0, 3))) === 0xefbbbf 判断，并在存在时用 substr($json, 3) 截除。
4、再次调用 json_decode()验证是否恢复正常解析。
五、利用在线工具与命令行辅助验证
当 PHP 环境受限或需交叉验证时，可借助外部工具确认 JSON 本身有效性，排除 PHP 配置或版本差异干扰。该方法不修改代码，仅用于诊断源头问题。
1、将待测 JSON 复制到 浏览器 访问 https://jsonlint.com/ 进行格式校验与美化。
2、在 Linux 终端执行echo ‘{“key”:”value”}’ | python3 -m json.tool，利用 Python 内置模块验证语法（需安装 Python3）。
3、使用 PHP CLI 直接运行单行命令：php -r “var_dump(json_decode(file_get_contents(‘data.json’), true));”，绕过 Web 服务器环境限制。
4、对比不同 PHP 版本下输出差异，例如在命令行分别运行 php7.4 -v 和php8.1 -v确认是否由版本升级引发兼容性变化。
