Composer.json 报错“Unexpected token }”是因JSON语法错误，如多余逗号、中英文标点混用、BOM头或换行符问题；需用编辑器校验、composer validate --strict、PHP json_decode定位及CI预检综合排查。
Composer.json 文件报错：Unexpected token } in JSON at position xxx
这是最典型的 JSON 语法错误，composer.json 里多了一个逗号、少了一个引号，或者用了中文标点。JSON 不容忍任何格式偏差，哪怕结尾多一个逗号都会让 composer install 直接失败。
- 用 VS Code 或 PHPStorm 打开
composer.json，开启「JSON 语言模式」——它会实时标红语法错误位置 - 不要手动写
require字段的版本号，比如"monolog/monolog": "3.0.0"写成"monolog/monolog": "3.0.0",（末尾逗号）在对象最后一项是非法的 - 检查所有双引号是否为英文半角，中文引号
“”或全角逗号，会导致解析器直接崩溃 - 如果从网页复制配置，先粘贴到纯文本编辑器（如记事本）中再转过去，避免隐藏控制字符
validate 命令不报错，但 composer install 仍失败
composer validate 只校验 JSON 结构和基本 schema，不验证包名是否存在、版本是否合法、PHP 版本约束是否满足。它通过 ≠ 能装成功。
- 运行
composer validate --strict，它会额外检查字段合法性（比如type是否在白名单中）、废弃字段（如已移除的archive配置） - 确认
php版本约束与当前环境匹配："require": {"php": "^8.1"}在 PHP 8.0 下必然失败，composer --version和php -v得对得上 - 某些私有仓库或自定义
repositories配置虽合法，但网络不通或认证失效时，install会卡在 fetch 阶段，看起来像语法问题
用 json_decode() 快速定位错误行（PHP 环境下）
当编辑器没提示、composer validate 也沉默时，手写一段 PHP 脚本是最准的“终极检测器”——它会明确告诉你哪一行哪个字符出错。
php -r "\$j = file_get_contents('composer.json'); var_dump(json_decode(\$j, true)); if (json_last_error()) { echo 'Error: ' . json_last_error_msg() . ' at line ' . (substr_count(substr(\$j, 0, json_last_error_offset()), \"\n\") + 1); }"
- 输出类似
Error: Syntax error at line 12，立刻跳转到第 12 行前后检查 - 注意：该命令依赖当前目录下的
composer.json，路径不对会读空文件导致误报 - Windows 用户请改用双引号包裹整个命令，并转义内部双引号（或改用 PowerShell）
CI/CD 流水线里 JSON 校验总失败？检查换行与编码
Git 自动转换换行符（CRLF ↔ LF）、编辑器保存为 UTF-8 BOM、甚至 IDE 插件自动添加尾随空格，都可能让 composer.json 在 CI 中被判定为非法。
- 在项目根目录加
.gitattributes，强制composer.json使用 LF 换行：composer.json text eol=lf - 用
file composer.json（Linux/macOS）或Get-Content composer.json -Encoding Byte | Select -First 3（PowerShell）确认无 BOM 头（UTF-8 BOM 是 0xEF 0xBB 0xBF） - CI 脚本里加一步预检：
composer validate --no-check-publish && php -r "json_decode(file_get_contents('composer.json')) or die('JSON parse failed: '.json_last_error_msg());"
