UnexpectedValueException几乎总是由composer.lock或vendor/composer/installed.json损坏引起；应先用jq或python3 -m json.tool验证JSON合法性，报错会明确指出行列，切勿手修，而应删lock后运行composer install重建，或执行composer update --lock安全重生成。
UnexpectedValueException 几乎总是由 composer.lock 或 vendor/composer/installed.json 文件损坏引起，不是代码或网络问题，别查 PHP 版本或镜像源。
怎么快速确认是 JSON 文件损坏
错误信息里出现 Invalid argument supplied for foreach()、Could not parse version constraint 或直接抛 UnexpectedValueException 且没堆栈时，优先验证这两个文件的 JSON 合法性：
- 运行
jq empty composer.lock：输出空行即合法；报错会明确指出第几行第几列（如parse error: Invalid string: control characters... at line 45, column 8） - 没装
jq？用python3 -m json.tool composer.lock > /dev/null，报错同样带行列号 -
php -l composer.lock完全无效——PHP 的语法检查不适用于 JSON 文件，别浪费时间 - 打开文件后开启编辑器「显示不可见字符」：重点看 BOM（
EF BB BF开头）、零宽空格、混用的\r\n和\n、中文引号、Unicode 转义不全（比如张三没写成\u5f20\u4e09）
报错指向 composer.lock 怎么修
如果 jq 或 json.tool 明确报 composer.lock 错误，别手修，风险高：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 最稳：删掉
composer.lock，再跑composer install——Composer 会按当前composer.json重生成一份干净的 lock - 想保留依赖版本但修复结构：执行
composer update --lock，它完全忽略旧 lock，只读composer.json重新计算哈希和依赖快照 - Git 合并冲突后残留的
<<<<< HEAD、=======、>>>>> origin/main会让 JSON 直接非法；即使侥幸通过语法检查，content-hash校验也会失败 - 删之前先备份，尤其多人协作项目；Git 提交漏掉
composer.lock，其他人composer install必然失败
报错指向 installed.json 怎么处理
vendor/composer/installed.json 是 Composer 运行时自动生成的，不能手动编辑：
- 常见原因是权限不足导致写入截断（尤其 Docker、WSL、共享目录），文件只有前半段 JSON，末尾缺失
} - Windows 下还可能因文件被占用（如 PhpStorm 正在索引、Swoole 进程锁住）造成写入失败
- 唯一可靠操作：删掉整个
vendor/目录 +composer.lock，再执行composer install - 别只删
vendor/composer/installed.json——它下次还会被写坏；也别试图“修复”它，Composer 不提供校验或重写接口
容易被忽略的深层坑点
有些损坏不报错，但会导致后续行为异常：
- Composer 1.x 生成的
composer.lock在 Composer 2.x 环境下可能结构不兼容，composer install会静默失败或装错包 - 中文路径或包名未正确转义（如
"name": "张三/工具"），旧版 Composer（json_decode() 默认拒绝，直接抛UnexpectedValueException - CI 流程中必须加
jq empty composer.lock校验步骤——否则损坏的 lock 被提交，所有协作者都会复现 -
composer validate只能发现基础字段缺失，无法捕获 Unicode 转义不全、BOM、控制字符等低层 JSON 问题
