JSON_ERROR_SYNTAX表示JSON语法错误，即输入字符串不符合JSON标准格式，常见原因包括单引号代替双引号、末尾多余逗号、键名或字符串值未加引号、未转义特殊字符、混入注释或非JSON内容等。
JSON_ERROR_SYNTAX 表示 PHP 在调用 json_decode() 时遇到了**语法错误**——输入的字符串不符合 JSON 标准格式，导致无法解析。
常见触发原因
这类错误不是编码问题，而是结构本身不合法。典型情况包括：
- 使用单引号代替双引号：
{'name': 'Alice'}→ 必须写成{"name": "Alice"} - 对象或数组末尾多了一个逗号：
{"a": 1,}或[1,2,] - 缺少引号包裹键名或字符串值：
{name: "test"}或{"msg": test} - 未转义特殊字符：比如字符串里直接包含换行符、制表符、未闭合的引号，或嵌入了 HTML/PHP 注释（如
// comment） - 返回内容根本不是 JSON：例如 API 出错返回了 502 页面、调试输出、PHP 错误信息，混在响应体里
如何快速定位和验证
不要只看 json_decode() 返回 null 就下结论。必须立刻检查错误类型：
$data = json_decode($json, true);<br>if ($data === null && json_last_error() === JSON_ERROR_SYNTAX) {<br> echo '语法错误：' . json_last_error_msg();<br> echo "\n原始字符串：\n" . htmlspecialchars($json);<br>}
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
立即学习“PHP免费学习笔记（深入）”；
实用修复建议
遇到语法错误，优先做这几件事：
- 把原始字符串粘贴到在线 JSON 验证工具（如 jsonlint.com）中，它会精准标出哪一行哪个字符出错
- 检查数据来源：前端拼接 JSON 时是否漏了引号？后端日志是否混入了非 JSON 内容？
- 用
trim()清除首尾空白或不可见字符（如 BOM、\r\n 换行） - 若来自用户输入或第三方接口，先做基础清洗：替换非法控制字符、移除注释、统一引号
注意区分相似错误
JSON_ERROR_SYNTAX 和 JSON_ERROR_UTF8 容易混淆。前者是“结构错”，后者是“字节错”——比如字符串含 GBK 编码的中文但没转 UTF-8，json_decode 也会失败，但报的是 JSON_ERROR_UTF8，不是语法问题。
