composer install报错八成因镜像配置错误：键名必须为repo.packagist（单数）、type值必须显式写composer、url须https且末尾带/，任一缺失即静默回退官方源；验证需输出完整json如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
Composer install 报错，八成不是网络差、不是 PHP 坏，而是镜像根本没配对——漏一个斜杠、少个 composer 类型参数、键名写成 repos.packagist，它就安静退回 https://packagist.org，不报错也不提示。
确认镜像是否真生效了
别信 composer config -g repo.packagist 输出“成功”，得看它返回的是不是完整 JSON。正确输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 这种结构。空、null、或还显示官方地址，说明配置压根没写进去。
常见失败原因：
-
repo.packagist写成复数形式（如repos.packagist或repositories.packagist）——Composer 2.x 直接忽略 - 命令里漏掉
composer这个 type 值：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 缺末尾斜杠：
https://mirrors.aliyun.com/composer❌ 会拼出/composerpackages.json导致 404；✅ 必须是https://mirrors.aliyun.com/composer/ - 没加
-g参数：只改当前项目composer.json，换目录就失效
项目级配置覆盖全局，你可能根本没走镜像
只要项目根目录的 composer.json 里有 "repositories" 字段（哪怕只是 "repositories": []），全局镜像设置就彻底失效——不是优先级低，是直接跳过。
排查和修复步骤：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config --unset repositories（注意没-g）临时清掉项目级配置 - 检查宝塔/CI 环境权限：你在终端用
root配的全局镜像，但实际执行的是www用户，得用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳妥的做法：进项目目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动写进composer.json的repositories字段，key 固定为"packagist"
卡在 “Loading composer repositories” 或报 SSL 错误？先校准系统时间
SSL certificate problem: certificate has expired 这类错误，99% 不是证书真过期，而是本地系统时间偏差太大（快或慢超 2 分钟），导致 HTTPS 证书有效期校验失败。
验证与修复：
- Linux/macOS：运行
date对比 time.is，若偏差 >2 分钟，执行sudo timedatectl set-ntp true && sudo systemctl restart systemd-timesyncd，再用timedatectl status | grep "System clock synchronized"确认输出yes - Windows：管理员打开 CMD，依次运行
w32tm /config /syncfromflags:manual /manualpeerlist:"time.nist.gov pool.ntp.org"→net start w32time→w32tm /resync - 临时绕过仅限调试：
composer config -g secure-http false+composer config -g cafile /dev/null（⚠️不安全，勿上生产）
删 vendor 和 lock 文件前，先确认是不是 autoload.php 没生成
Unable to load autoload.php 这个错误和镜像无关。它只说明 vendor/autoload.php 不存在或路径引用错了。
真实原因往往很朴素：
-
composer install执行中途被Ctrl+C中断，vendor/目录不完整 - 手动删了
vendor/，但只跑composer dump-autoload，没重新install - PHP CLI 和 Web Server 用的不是同一套扩展（比如 CLI 开了
openssl，而 Apache 没开），导致命令行能装成功，但网页加载失败
解决方法简单粗暴：rm -rf vendor/ composer.lock，再跑一次 composer install。别省这一步——缓存、lock、vendor 三者必须同步，缺一不可。
