“your requirements could not be resolved”是依赖冲突，非网络或权限问题；本质是composer无法找到满足所有约束的版本组合，常见于php版本/扩展不匹配、死版本号冲突或老旧包强制低版本依赖。
Composer 报错不是随机发生的，而是环境、配置、权限或网络中某个具体环节出了问题。直接看错误关键词，比重装 Composer 有效十倍。
报错含 “Your requirements could not be resolved”
这说明依赖约束之间冲突，不是网络或权限问题。Composer 算不出一套满足所有 require 条件的版本组合。
- 运行
composer why-not php:8.3（把8.3换成你目标 PHP 版本），直接定位哪个包在拦路 - 常见原因：Laravel 升级后没同步更新配套包；手动锁死某个包版本（如
"monolog/monolog": "2.9.0"）；老旧 bundle（如jms-security-extra-bundle）强制要求 Symfony 2.x 或 PHP 5.6 - 别删
composer.lock——它记录的是已验证可行的版本组合，删了会让问题更难复现 - 临时绕过可用
composer install --ignore-platform-reqs，但仅限调试；上线前必须修复真实兼容性，否则ext-pcntl、ext-redis缺失也不会报错
卡在 “Loading composer repositories” 或提示 “Connection timed out”
国内直连 packagist.org 基本不可靠，本质是 DNS、TLS 握手或中间链路被阻断，不是你本地坏了。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 换镜像源最有效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 清缓存（换源后必做）：
composer clear-cache - 企业网或弱网可延长超时：
composer config -g process-timeout 3000和composer config -g http-timeout 600 - 某些防火墙拦截 SNI 请求，可临时关 TLS 验证：
composer config -g secure-http false（仅限开发机，生产禁用） - CI 脚本里反复执行
config切源反而拖慢构建，全局配一次就够了
Permission denied: failed to create directory vendor/
这是典型的权限错乱，尤其多见于 WSL、Docker 或误用 sudo 后遗症。根本不是 Composer 不行，是你当前用户没权利写那个路径。
- 绝对不要用
sudo composer install——会让vendor/下所有文件属主变成root，后续php artisan或启动本地服务器直接失败 - WSL 用户若项目放在
/mnt/c/xxx下，NTFS 不支持 Linux 权限模型，chmod无效；唯一稳解是移到 WSL 原生路径，比如~/projects/myapp - 检查归属：
ls -ld vendor ~/.composer/cache，若属主是root，修复命令：sudo chown -R $USER:$USER vendor ~/.composer/cache - 可改缓存目录到用户可控位置：
composer config -g cache-dir ~/composer-cache
PHP version does not satisfy 或 Call to undefined function
很多人只看 php -v 显示 8.2 就以为过关，但 CLI 和 Web 可能用不同 php.ini，扩展也可能没开全。
- 运行
php -m | grep -E "curl|json|openssl|phar|zlib"，缺哪个就去php.ini里取消对应;extension=xxx的注释 - 确认
allow_url_fopen = On，否则 Composer 无法远程拉取包信息 - Windows 用户注意：XAMPP/MAMP 的 CLI
php.ini路径通常在php\phpX.X.X\目录下，和 Apache 用的不是同一个 - 用
php --ini查真实加载路径，用php -i | grep 'Loaded Configuration File'验证 - 系统时间偏差超过 5 分钟也会导致 TLS 握手失败，运行
date检查并校准
真正难排查的其实是 PHP CLI 和 Web 服务器加载的配置不一致——比如 php -m 显示有 openssl，但 php -i 显示 CLI 加载的是另一个 php.ini。这种差异比网络问题更隐蔽，也更常导致安装中途静默失败。
