绝大多数composer install报错源于环境配置、网络链路或缓存残留；报“Connection refused”说明仍在直连packagist.org被阻断，须用composer config -g repo.packagist验证镜像配置、执行clear-cache并检查composer.json中是否误存repositories字段。
绝大多数 composer install 报错，根源不在代码本身，而在环境配置、网络链路或缓存残留——直接重试或删 vendor 通常无效，必须按错误关键词定位。
报 “Connection refused” 或卡在 “Downloading”
这不是你本地断网，而是 Composer 还在尝试直连 packagist.org，被策略阻断。国内默认直连基本不可用。
- 运行
composer config -g repo.packagist，输出必须是类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}—— 缺斜杠、少composer类型参数、没加-g都会导致静默失效 - 换源后必须执行
composer clear-cache，否则旧 provider 地址仍会复用 - 验证真实请求地址：运行
composer install -vvv 2>&1 | grep -i "host\|mirrors"，第一行出现的域名才是实际访问目标 - 如果日志里仍是
packagist.org，检查项目根目录下composer.json是否含"repositories"字段（哪怕只是空数组[]），有就删掉或临时执行composer config --unset repositories
报 “404 Not Found” 或 “file could not be downloaded”
404 不代表包不存在，而是你请求了一个拼错的 URL，常见于镜像地址写漏斜杠、用了已停服的源（如 phpcomposer.com）。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动测镜像是否存活：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回HTTP/2 200；返回 404 或 HTML 页面（如人机验证）说明该镜像不适合自动化场景 - 确认镜像 URL 是 HTTPS 且末尾带
/：写成https://mirrors.aliyun.com/composer（缺斜杠）会拼出/composerpackages.json这种非法路径 - 删掉
vendor/和composer.lock再重装——composer.lock里硬编码了旧 provider 地址，不清除它，换源也白搭 - 避免使用已失效源：
laravel-china.org和phpcomposer.com自 2022 年起固定返回 404，立刻停用
报 “cURL error 60” 或 “certificate verify failed”
这是 PHP 的 OpenSSL 扩展找不到可信 CA 证书，和 Composer 配置无关，常见于 Docker 容器、CentOS 虚拟机或系统时间偏差 >5 分钟的 macOS。
- 查证书路径：
php -r "print_r(openssl_get_cert_locations());"，重点关注default_cert_file值 - 若路径为空或指向不存在的文件（如
/etc/ssl/certs/ca-certificates.crt但未生成），需手动下载并配置：curl -sS https://curl.se/ca/cacert.pem -o /path/to/cacert.pem，然后在php.ini中设curl.cainfo = "/path/to/cacert.pem" - 检查系统时间是否准确：
date，误差超过 5 分钟会导致 TLS 握手失败 - 临时绕过（仅限开发机）：
composer config -g secure-http false，但上线前必须修复证书问题
报 “Your requirements could not be resolved”
这个错误说明 Composer 已成功连上镜像、拿到元数据，但在本地求解依赖时发现版本约束冲突——跟网络、镜像、权限都无关，纯逻辑问题。
- 运行
composer why-not php:8.3（把 8.3 换成你目标版本），直接看到哪个包在拦路，比如laravel/framework v10.42.0 requires php ^8.1，但另一个包锁死了php: ^7.4 - 检查
composer.json里是否有写死版本号，例如"monolog/monolog": "2.9.0"，而新引入包要求^3.0，两者无交集 - 确认 CLI 环境真实可用：
php -v和php -m | grep -E "mbstring|openssl|curl|json"，Web 和 CLI 可能加载不同php.ini - 临时跳过平台检测：
composer install --ignore-platform-reqs，但它不解决问题，只掩盖；上线前必须让代码真兼容目标环境
最常被忽略的是 composer.lock 里固化了旧 provider 地址，以及项目级 repositories 配置会完全屏蔽全局镜像——这两点不处理，其他操作都是白忙。
