答案是90%的Composer install失败源于网络、权限、时钟偏差或配置错误，应优先根据报错关键词排查：DNS失败需换DNS并验证；镜像未生效须检查全局配置JSON、清缓存；SSL过期实为系统时间偏差＞2分钟；Permission denied多因sudo污染导致归属错误，需chown修复而非chmod。
Composer install 报错，90% 不是 Composer 本身的问题，而是网络、权限、时钟或配置写错了——直接看报错关键词，比重装 Composer 有用十倍。
报 “Could not resolve host” 或 “Connection refused”
这是 DNS 或系统级连通失败，不是镜像没配好，也不是 PHP 扩展问题。
- 先跑
ping packagist.org：返回unknown host就是 DNS 污染，别折腾 composer config，立刻换 DNS（比如设为8.8.8.8） - 再跑
composer config -g repo.packagist：输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或还是https://packagist.org，说明根本没配成功 - 换源后必须清缓存：
composer clear-cache，否则它还在用旧失败记录重试 - 企业内网若走代理，
curl -v https://mirrors.aliyun.com/composer/卡在* Connected to是 DNS 或防火墙问题，卡在* TLS handshake可能需强制 IPv4：CURL_IPRESOLVE=4 composer install
报 “SSL certificate problem: certificate has expired”
这不是证书真过期了，是本地系统时间偏差太大（快或慢 >2 分钟），导致 HTTPS 证书校验失败。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 运行
date对比 time.is，偏差超 2 分钟就执行：sudo timedatectl set-ntp true&&sudo systemctl restart systemd-timesyncd - Windows 管理员运行：
w32tm /resync；若报服务未启动，先net start w32time，再指定可靠源：w32tm /config /syncfromflags:manual /manualpeerlist:"time.nist.gov pool.ntp.org" - 临时禁用 SSL 校验（仅调试）：
composer config -g secure-http false+composer config -g cafile /dev/null，但不解决根本问题，且不安全
报 “Permission denied” 写 vendor/ 或 autoload.php
绝大多数不是缺写权限，而是目录归属被 sudo 污染过，当前用户无权修改。
- 查归属：
ls -ld vendor/ composer.lock，如果属主是root，而你是普通用户，就会失败 - 修复命令：
sudo chown -R $USER:$USER vendor/ composer.lock（Linux/macOS）或takeown /f vendor /r+icacls vendor /grant %USERNAME%:F /t（Windows） - 别用
chmod 777硬刚——它不解决归属问题，反而可能引发后续 autoload 加载失败 - 如果
vendor/autoload.php不存在，不是镜像问题，是composer install被中断或没跑完，直接rm -rf vendor composer.lock再重来
报 “Your requirements could not be resolved”
这是依赖版本冲突，和网络无关，composer install -vvv 会卡在解析阶段，不是下载卡住。
- 先确认 PHP 版本兼容性：
php -v和composer.json里"php": "^8.1"是否匹配 - 运行
composer why-not xxx（比如composer why-not laravel/framework ^11.0），它会指出哪个包锁死了版本 - 删掉
composer.lock再跑composer install—— lock 文件硬编码了旧解析结果，不清它，Composer 就不会重新尝试 - 如果项目用了老旧扩展（如
ext-mcrypt），PHP 7.2+ 已移除，得改依赖或换替代方案，不是换镜像能解决的
最容易被忽略的点：项目根目录 composer.json 里只要存在 "repositories" 字段（哪怕只是空数组 []），全局镜像配置就完全失效——不是优先级低，是压根不读。别只信 composer config -g 的输出，得打开 composer.json 看一眼。
