Composer install报错实用排查手册-composer-PHP中文网

“file could not be downloaded”或卡在“loading composer repositories”基本是网络链路问题，需切阿里云镜像、清缓存、用-vvv验证真实请求地址；“permission denied”多因目录属主为root，应chown修复归属；“your requirements could not be resolved”是依赖冲突，须用why-not等命令精准定位。

composer install报错实用排查手册

报错里带“file could not be downloaded”或卡在“Loading composer repositories”

这基本是网络链路问题，不是你本地 PHP 坏了，也不是 Composer 版本低。Packagist.org 直连在国内几乎不可用，DNS 解析失败、TLS 握手超时、中间人拦截都可能触发。

立刻执行三步：

切阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾 / 不能少）
清缓存：composer clear-cache（Windows 还要手动删 %LOCALAPPDATA%\Composer\cache）
验证真实请求地址：composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是你实际在访问的源

如果 curl -I https://mirrors.aliyun.com/composer/packages.json 返回 HTML 页面（比如人机验证），说明这个镜像不适合自动化场景，换腾讯云或华为云源。

报“Permission denied”写 vendor/ 或 composer.lock

这不是权限位（rwx）不够，而是目录“认错了主人”。90% 是之前误用 sudo composer install，导致 vendor/、composer.lock 或 ~/.composer 属主变成 root，而你现在以普通用户运行。

先定位问题路径：

ls -ld vendor/ composer.lock —— 看属主是不是 root
composer config --global cache-dir —— 拿到缓存路径，再 ls -ld 查归属
whoami —— 确认当前用户是谁

修复只用 chown，别碰 chmod：

项目内：sudo chown -R $USER:$USER vendor/ composer.lock
全局缓存：sudo chown -R $USER:$USER $(composer config --global cache-dir)

如果整个 ~/.composer 都被 root 占了，直接 sudo chown -R $USER:$USER ~/.composer。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

报“Your requirements could not be resolved”

这不是网络或权限问题，是依赖约束之间打架了。Composer 已经拿到所有元数据，但在本地找不到一组满足全部版本要求的组合。

关键动作是定位拦路包：

运行 composer why-not php:8.3（把 8.3 换成你目标 PHP 版本），输出会直接告诉你哪个包锁死了旧版本
检查 composer.json 里有没有写死具体版本号，比如 "monolog/monolog": "2.9.0"，而新包要求 ^3.0
确认 CLI 环境真实可用：php -v 和 php -m | grep -E "mbstring|openssl|curl|json"，Web 和 CLI 的 php.ini 可能完全不同

--ignore-platform-reqs 只是绕过检查，不会解决根本冲突，上线前必须让代码真兼容目标环境。

镜像配置看起来成功却没生效

composer config -g repo.packagist 输出为空、null 或仍是官方地址，说明配置压根没写进去，不是“没生效”，是命令根本失败了。

三个硬条件缺一不可：

键名必须是 repo.packagist（单数，不是 repos.packagist 或 repositories.packagist）
命令末尾必须显式传入 composer 作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
URL 必须 HTTPS 且以 / 结尾，否则拼出 /composerpackages.json 这种非法路径

更隐蔽的坑是项目级配置优先级高于全局：只要 composer.json 里有 "repositories" 字段（哪怕只是空数组 []），全局镜像就彻底失效。临时清掉它：composer config --unset repositories（注意没 -g）。