针对Composer install报错的简明排查手册-composer-PHP中文网

“your requirements could not be resolved”不是依赖冲突或网络问题，而是本地php版本、扩展缺失或platform配置与composer.lock中锁定的包运行前提不匹配所致，需检查php -v、php -m及composer.json中的platform设置。

针对composer install报错的简明排查手册

报“Your requirements could not be resolved”不是网络问题，是环境不匹配

这个错误常被误认为依赖冲突，其实它发生在 composer install 阶段，说明 Composer 已读取 composer.lock，但本地 PHP 环境无法满足其中某个包的硬性要求。

运行 php -v 确认 CLI 版本，别只看 phpinfo() 页面——Web 和 CLI 可能加载不同 php.ini
检查缺失扩展：php -m | grep -E "mbstring|xml|curl|openssl|fileinfo"，ext-fileinfo 缺失会导致 league/flysystem 类直接失败
看 composer.json 顶部 "config": {"platform": {...}} 是否写死了 "php": "8.2.10"，而你实际是 8.1.25，就会触发该报错
临时验证可用性可加 --ignore-platform-reqs，但装完大概率运行时报 Class not found 或函数不存在

卡在 “Loading composer repositories” 或 “Downloading” 是镜像没生效

国内直连 packagist.org 基本不可靠，但很多人配了镜像却没生效，因为配置被覆盖或缓存残留。

必须用全局配置：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意结尾 /、单数 repo.packagist、末尾 composer 类型）
项目级 composer.json 里只要出现 "repositories": []，哪怕空数组，也会屏蔽全局镜像——执行 composer config --unset repositories 清掉
验证是否真走镜像：composer install -vvv 2>&1 | grep -m1 Downloading，第一行 URL 才是真实请求地址
切源后必须清缓存：composer clear-cache；Windows 用户还得手动删 %LOCALAPPDATA%\Composer\cache

报 “Permission denied” 别急着 chmod，先查属主

90% 的权限错误不是缺写权限，而是目录被 sudo composer install 污染过，导致 vendor/ 或 ~/.composer 属主变成 root，而你当前是普通用户。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

报错里带路径就是线索：file_put_contents(/path/to/vendor/autoload.php): Permission denied → 直接查 ls -ld vendor/
修复命令：sudo chown -R $USER:$USER vendor/ composer.lock ~/.composer（不要 chmod 777，那会埋安全漏洞）
CI/CD 或宝塔常见陷阱：你用 root 配了全局镜像，但构建脚本以 www 用户运行——得用 sudo -u www composer config -g ... 单独配

报 “file could not be downloaded” 或 SSL 错误，重点查 `curl.cainfo`

这类错误不是 Composer 配错了，而是 PHP 的 cURL 根证书路径没设对，导致 TLS 握手失败，尤其在 CentOS、macOS 或自编译 PHP 环境中高频出现。

运行 php --ini 找到真实加载的 php.ini 路径
编辑该文件，确认有且仅有一行：curl.cainfo = "/path/to/cacert.pem"（Linux/macOS 通常为 /etc/ssl/certs/ca-certificates.crt，Windows 可下载 cacert.pem 并填绝对路径）
改完重启终端或 Web 服务，再运行 php -r "print_r(openssl_get_cert_locations());" 验证 default_cert_file 是否已更新
企业内网若拦截 SNI，可临时关校验：composer config -g secure-http false（仅限开发机）

最常被忽略的一点：报错关键词决定排查路径。看到 Connection refused 就别翻 composer.json，立刻查 DNS 和代理；看到 ext- 开头就别重装 Composer，去装扩展；看到 Permission denied 后面跟着路径，第一反应是 ls -ld，不是 chmod。