composer update 卡住或报错主因是旧镜像失效，应切换至阿里云或腾讯云镜像，清理 vendor 和 composer.lock 后执行 install 而非 update，并检查项目级配置是否覆盖全局设置。
Composer update 卡在 packagist.org 或报 404/500 错误
这基本是镜像源配置失效或过期导致的——国内主流镜像（如腾讯、阿里、华为）已陆续停用旧版 Composer 镜像服务，packagist.phpcomposer.com 和 packagist.laravel-china.org 已不可用。直接执行 composer update 时，若仍沿用这些地址，会返回 Connection refused 或 404 Not Found，甚至静默失败后残留损坏的 vendor/ 和 composer.lock。
当前稳定可用的中文镜像只有两个：
-
https://mirrors.aliyun.com/composer/（阿里云，推荐） -
https://mirrors.tencent.com/composer/（腾讯云，偶有同步延迟）
执行前先确认是否还在用已下线的镜像：
composer config -g repo.packagist
如果输出包含已停用域名，必须立刻切换；否则后续 composer install 可能因 lock 文件里记录了失效 URL 而反复失败。
切换镜像后 vendor 目录仍报 autoload 错误
镜像只是加速下载，不改变包内容。但若之前更新中断过，vendor/ 里可能混入了半成品包（比如只有 src/ 没 composer.json），导致 composer dump-autoload 失败或运行时报 Class not found。
安全做法是彻底清理再重装：
- 删掉整个
vendor/目录和composer.lock - 确保
composer config -g repo.packagist已设为阿里云地址 - 运行
composer install（不是update），它会按 lock 文件重建依赖，更可靠
注意：composer update 会重新解析依赖树，容易触发新版本兼容问题；而 install 只还原 lock 记录的精确版本，更适合修复损坏状态。
项目级镜像配置 vs 全局配置冲突
如果项目根目录有 composer.json 且含 repositories 字段，它会覆盖全局镜像设置。常见陷阱是：全局切到了阿里云，但项目里还硬编码着旧镜像 URL，结果 composer update 实际走的仍是失效地址。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
检查项目级配置：
grep -A 5 "repositories" composer.json
若发现类似：
"repositories": [{"type": "composer", "url": "https://packagist.phpcomposer.com"}]
请直接删除该段，或改写为：
"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]
更稳妥的做法是：项目中不写 repositories，统一靠全局配置管理，避免多处维护出错。
PHP 8.2+ 下阿里云镜像偶尔 503 的应对方式
阿里云镜像对 PHP 8.2+ 的某些 User-Agent 字符串响应不稳定，表现为 composer install 随机失败，错误信息含 503 Service Temporarily Unavailable。
临时绕过方法（无需改镜像）：
- 加
-vvv参数看真实请求 URL 和响应头 - 手动下载失败的 tarball（日志里会打印完整 URL），放本地再用
composer install --offline - 或降级 Composer 到
2.5.x（composer self-update --2.5），它发请求时 UA 更兼容
长期建议关注 composer config -g repos.packagist.allow_ssl_downloads true 是否开启——某些企业网络拦截 HTTPS 重定向也会伪装成 503。
镜像只是通道，真正的依赖一致性靠 composer.lock 维护；一旦这个文件被破坏或混入无效 URL，光换镜像是没用的。最省事的修复路径永远是：删 vendor + 删 lock + 重 install。
