composer install/update 报错“unexpected end of json”是因 composer.json 或缓存中json文件格式非法，常见于漏/多逗号、引号未闭合、文件截断等；应先用 composer validate 校验，再清缓存或手动修复json。
Composer install/update 报错 Unexpected end of JSON
这是 Composer 读取本地 composer.json 或缓存中的 JSON 文件时，遇到格式不合法导致的解析失败。最常见原因是手动编辑 composer.json 后漏了逗号、多写了逗号、引号没闭合，或文件被意外截断（比如编辑器崩溃、磁盘满、Git 合并冲突残留）。错误信息通常长这样：Parse error: syntax error, unexpected end of file in phar:///usr/bin/composer/src/Composer/Json/JsonFile.php
快速定位是哪个 JSON 文件损坏
Composer 会依次读取多个 JSON 文件：项目根目录的 composer.json、全局配置 ~/.composer/auth.json（如果存在）、以及缓存里解压的包元数据（如 ~/.composer/cache/repo/https---packagist.org/packages.json）。按优先级顺序排查：
- 先运行
composer validate—— 它只校验当前目录的composer.json，能最快确认是不是它坏了 - 如果
validate通过，但install仍报错，尝试清空缓存：composer clear-cache，再重试 - 仍不行？检查
~/.composer/auth.json是否存在且格式正确（尤其你手动加过 OAuth token 的时候）
修复 composer.json 的实际操作
别直接靠肉眼找括号——用工具验证更可靠：
- 在终端运行
python3 -m json.tool composer.json（macOS/Linux 自带；Windows 可装 Python 或用在线校验器） - 错误行号会直接输出，比如
Expecting property name enclosed in double quotes就说明某处缺 key 或引号不匹配 - 常见低级错误：
"require": { "php": "^8.1"少了个}；"description": "My app",最后多逗号（PHP 兼容但 JSON 不允许）；用中文引号“”代替英文双引号 - 如果改多次仍失败，从
composer init重新生成一份最小composer.json，再把原require和autoload段落复制进去
为什么有时清缓存也不管用？
因为 Composer 会把远程仓库的 packages.json 缓存为二进制格式（.json.gz），而损坏可能发生在解压后的临时 JSON 文件中，这些文件不会被 clear-cache 彻底清理干净：
- 手动删掉整个缓存目录更彻底：
rm -rf ~/.composer/cache（Linux/macOS）或rd /s/q "%APPDATA%\Composer\Cache"（Windows） - 如果公司用了私有 Packagist（如 Satis 或 Private Packagist），检查其服务端返回的 JSON 是否本身就有格式问题（curl 直接请求 API 看响应体）
- 某些 IDE（如 PHPStorm）在「保存时格式化 JSON」选项开启后，可能自动删掉末尾换行，导致某些旧版 Composer 解析出错 —— 关掉该选项或确保文件以换行结尾
JSON 格式看着简单，但 Composer 对它的严格性远超 PHP 数组语法；一个看不见的 BOM、编辑器自动插入的不可见字符、甚至 Git 的 CRLF 转换都可能让解析器卡在“unexpected end”。修之前，先 cat -A composer.json 看有没有 ^M 或 M-BM- 这类标记。
