composer install报错八成因镜像未配对、缓存污染或权限错误；需严格满足repo.packagist单数、显式type值composer、https末尾带/三条件，清缓存删vendor与lock，并验证真实请求地址。
Composer install 报错，八成不是 PHP 坏了、也不是网络真断了，而是镜像没配对、缓存已污染、或 vendor 目录被“认错主人”。
composer config -g repo.packagist 配置无效？检查这三处硬性要求
这条命令静默失败很常见，根本原因不是命令错了，而是三个条件缺一不可：
-
repo.packagist必须是单数形式，写成repos.packagist或repositories.packagist都会被 Composer 2.x 完全忽略 - 必须显式传入
composer作为 type 值：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间的composer，配置就白写了 - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，而https://mirrors.aliyun.com/composer❌（拼路径时变成/composerpackages.json，404）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或还是 https://packagist.org，说明根本没存成功。
composer install 卡在 “Loading composer repositories” 或报 SSL 错误？先看真实请求地址
镜像只加速元数据和 ZIP 包拉取，不解决证书链或缓存污染问题。卡住 ≠ 没换源，可能根本没走你配的地址。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址；别光看composer config输出 - 检查项目根目录
composer.json是否含"repositories"字段：哪怕只是"repositories": []，也会完全屏蔽全局镜像 - 执行
composer config --unset repositories（注意没-g）临时清掉项目级配置再试 - 某些 CI/宝塔环境里，你用
root配的全局镜像，但实际运行的是www用户，得用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/单独配
报 “Permission denied” 写 vendor/ 或 composer.lock？别急着 chmod
绝大多数不是权限不足，而是目录归属被 sudo 污染过——vendor/、composer.lock 或 ~/.composer 属主是 root，而你正以普通用户运行命令。
- 报错里带路径的那一行就是线索：
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题就在vendor/ - 立刻检查归属：
ls -ld vendor/ composer.lock $(composer config --global home)，如果属主是root，就用sudo chown -R $USER:$USER vendor/ composer.lock ~/.composer修复 - Windows 下报
Access is denied，常是杀软拦截了.bat文件生成，临时禁用 Windows Defender 实时防护再试；或改用 Git Bash 运行，它会把 bin 脚本转为 shell wrapper，避开 UAC 拦截
换镜像后仍报 404、JSON decode error 或 “SSL certificate problem”？缓存和时间都得动
这些错误往往不是镜像本身不可用，而是旧缓存、损坏元数据、或系统时钟偏差导致 HTTPS 校验失败。
- 先执行
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删掉
vendor/和composer.lock——composer.lock里硬编码了旧 provider 地址，不删它，Composer 就一直重试失败路径 - 运行
date查系统时间，若比time.is快或慢超 2 分钟，HTTPS 证书校验就会失败；Linux/macOS 执行sudo timedatectl set-ntp true && sudo systemctl restart systemd-timesyncd，Windows 执行w32tm /resync - 手动验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200；若返回 HTML 页面（如人机验证），说明该镜像不适合自动化场景
最易被忽略的一点：项目级 repositories 字段的存在，会让全局镜像配置彻底失效——不是优先级低，是直接跳过。排查时永远先确认 composer.json 里有没有这个字段，而不是反复重配 -g。
