JSON报invalid character错误90%因全角引号、BOM、中文标点或注释;须用半角英文引号"、UTF-8无BOM编码、删注释,并用composer validate定位具体行列。

检查 JSON 中的中文引号和不可见字符
Composer 报 invalid character in json,90% 是因为用了全角引号(“”)、中文顿号、空格或复制粘贴带 BOM 的文本。JSON 只认 ASCII 引号 ",不接受 “ 或 ”,也不接受 Windows 记事本保存的 UTF-8+BOM。
- 用 VS Code、Sublime 或 Vim 打开
composer.json,确认所有引号都是英文半角双引号" - 在 VS Code 中右下角查看编码格式,如果不是
UTF-8(无 BOM),点击切换并重新保存 - 终端执行
file -i composer.json(Linux/macOS)或Get-Content composer.json -Encoding UTF8 | Format-Hex(PowerShell)排查隐藏字符 - 临时重写最简配置验证:用
{"name":"test/test","require":{}}替换原文件内容,再逐步加字段
验证 JSON 结构是否合法(逗号、括号、冒号)
JSON 对标点极其敏感:末尾多逗号、缺冒号、括号不闭合都会触发该错误。尤其容易在 require 或 autoload 块中手误。
- 运行
php -l composer.json无法检测 JSON 语法,要用json_decode(file_get_contents('composer.json'), true) === null测试,或直接用在线工具如 jsonlint.com - 常见错误示例:
{"require": {"monolog/monolog": "^2.0",}}—— 末尾逗号非法 {"autoload": {"psr-4": {"App\\": "src/"}}}缺少,后续字段时易漏掉前面的闭合- 嵌套对象里混用单引号(
'App\\')会导致解析失败,JSON 不支持单引号
注意 Composer 特定字段的格式限制
有些字段看似是字符串,实则要求严格格式,比如 version、license、autoload 的键名,填错会间接导致 JSON 解析器读到非法 token。
-
version字段值必须是字符串,不能写成1.0.0(无引号),否则 JSON 解析为数字,Composer 会拒绝 -
license必须是字符串或字符串数组,写成MIT(无引号)是非法 JSON -
autoload下的psr-4键必须是命名空间字符串结尾带反斜杠,如"App\\",少一个\会被当成转义错误 - 注释不是 JSON 标准语法,
//或/* */会直接报 invalid character,删掉所有注释再试
用 composer validate 快速定位问题行
composer validate 不仅校验 JSON 语法,还检查 Composer Schema 合法性,且会提示具体出错位置(行号+列号),比纯 JSON 解析更实用。
- 运行
composer validate --no-check-publish --no-check-all跳过网络校验,聚焦本地语法 - 输出类似
[Seld\JsonLint\ParsingException] "./composer.json" does not contain valid JSON Parse error on line 12 at column 17: syntax error, unexpected ',',立刻去第 12 行看第 17 列前后 - 如果提示
requires a non-empty string,说明某字段值为空字符串或 null,JSON 允许"key": "",但 Composer 某些字段禁止空值(如name) - 某些 IDE 插件(如 PHPStorm 的 JSON 支持)能实时高亮语法错误,开启后编辑时就能避坑
真正卡住的时候,不要逐行肉眼扫——先用 composer validate 定位行号,再用编辑器显示不可见字符(VS Code 按 Ctrl+Shift+P → “Toggle Render Whitespace”),最后只保留最小可运行结构逐步扩展。JSON 错误的表象千奇百怪,根源往往就藏在那一个引号、一个逗号或一个没转义的反斜杠里。










