该错误通常由 composer.lock 或 vendor/composer/installed.json 文件损坏引起，如 json 格式错误、bom 头、Unicode 转义不全、权限不足导致写入截断等；应优先用 jq 或 python3 -m json.tool 验证 JSON 合法性，删除损坏文件后重装。
Composer install 报错 UnexpectedValueException: Invalid argument supplied for foreach()
这个错误通常不是代码问题，而是 composer.lock 或 vendor/composer/installed.json 文件损坏导致的。Composer 在解析这些 JSON 文件时遇到格式错误（比如末尾多逗号、缺少引号、Unicode 转义不全、BOM 头），就会抛出 UnexpectedValueException，且错误信息往往不指明具体哪一行——这是最让人头疼的地方。
- 优先检查
composer.lock：用 VS Code 或 sublime 打开，开启「显示不可见字符」，看是否有 BOM（EF BB BF开头）、换行符异常（rn混用）、或编辑器自动插入的零宽空格 - 用命令行验证 JSON 合法性：
php -l composer.lock不起作用（PHP 不校验 JSON），应改用：jq empty composer.lock（需安装jq）或python3 -m json.tool composer.lock > /dev/NULL - 如果报错指向
vendor/composer/installed.json，不要手动编辑它——它是 Composer 自动写入的，直接删掉vendor/和composer.lock，再运行composer install
JSON 中中文路径或包名导致解析失败
某些 windows 环境下，Composer 会把含中文的 vendor 路径或包描述写进 installed.json，但未正确转义 Unicode 字符（例如写成 张三 而非 u5f20u4e09），PHP 的 json_decode() 默认拒绝这种非标准格式，直接 throw UnexpectedValueException。
- 临时规避：在
composer.json中加配置禁止写入非 ASCII 描述："config": { "sort-packages": true, "platform": { "php": "8.1" } }（虽不直接解决，但可减少乱码触发概率） - 根治方法：升级到 Composer 2.5+（2023 年后版本），它对 UTF-8 的处理更健壮；旧版可强制重生成：
composer update --lock替换 lock 文件，再rm -rf vendor && composer install - 注意：git 提交时若
composer.lock已损坏，其他协作者 pull 后也会复现——务必在 CI 流程中加入jq empty composer.lock校验步骤
vendor/composer/installed.json 权限或只读导致写入截断
尤其在 docker 容器、Windows WSL 或共享目录中，vendor/composer/installed.json 可能因权限不足被部分写入（比如只写入了前半段 JSON），造成文件语法不完整。此时 composer install 下次读取它就会崩在 foreach() 解析环节——因为 json_decode() 返回 null，而 Composer 没做空值防护。
- 检查文件大小：
ls -lh vendor/composer/installed.json，正常应在 10KB–100KB 区间；若只有几百字节，基本确认被截断 - 修复命令链：
chmod u+w vendor/composer/ && rm -f vendor/composer/installed.json && composer install - Docker 用户注意：
composer install应在构建阶段执行（即Dockerfile的RUN中），而非挂载 volume 后在容器里运行，否则宿主机权限策略可能干扰写入
实际排查时，别急着重装 Composer 或清全局缓存——90% 的 UnexpectedValueException 都卡在本地项目某个 JSON 文件的物理损坏上，而且往往就差一个逗号或一个 BOM。