答案：这是元数据拉取失败，与vendor无关，只和镜像地址、TLS证书、DNS解析有关；需先用curl验证镜像连通性，再检查全局配置是否为完整JSON、末尾有斜杠，确认无项目级repositories覆盖，并排查CA证书及环境变量干扰。
报“Could not fetch packages.json”或卡在Loading composer repositories
这是元数据拉取失败，和 vendor/ 内容无关，只和镜像地址、TLS 证书、DNS 解析有关。别急着删缓存，先验证基础连通性。
- 用
curl -I https://mirrors.aliyun.com/composer/packages.json测试：必须秒回HTTP/2 200；返回404、HTML 页面或超时，说明镜像 URL 写错或已失效 - 检查配置是否真生效：
composer config -g repo.packagist输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；输出为空、null或https://packagist.org，说明配置没落盘 - 注意末尾斜杠：写成
https://mirrors.aliyun.com/composer（缺/）会导致 Composer 拼出/composerpackages.json这种非法路径，直接 404 - 确认 PHP 的 CA 证书可用：
php -r "print_r(openssl_get_cert_locations());"查看default_cert_file是否指向有效文件；若为空或路径不存在，需手动下载cacert.pem并配置openssl.cafile
换源后仍请求 packagist.org？查项目级配置覆盖
全局镜像配置会被项目级 repositories 字段彻底屏蔽——哪怕只是空数组 []，Composer 也会忽略 repo.packagist。
- 进项目目录运行
composer config repositories，看输出里packagist的url是不是你设的镜像地址；如果不是，说明被覆盖了 - 检查
composer.json是否含"repositories"字段：有就删掉，或重写为"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}} - 环境变量优先级更高：
echo $COMPOSER_REPO_PACKAGIST，如果非空，它会直接覆盖所有 config 设置 - 验证真实请求目标：运行
composer install -vvv 2>&1 | grep -i "host\|mirrors"，第一行出现的域名才是实际访问地址
报“404 Not Found”或“file could not be downloaded”
这不是包不存在，而是 Composer 构造的下载 URL 错了——常见于镜像地址拼写错误、用了已下线源，或本地缓存了过期元数据。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 停用所有已失效源：
laravel-china.org、phpcomposer.com、packagist.phpcomposer.com自 2022 年起固定返回 404，立刻从 config 和composer.json中清除 - 删掉
vendor/和composer.lock：旧composer.lock里硬编码了 provider 地址，不清除它，换源也白搭 - 强制刷新元数据：
composer update --refresh，让 Composer 忽略本地缓存，重新拉取packages.json - 华为云用户注意路径：
https://repo.huaweicloud.com/php/（结尾是/php/，不是/composer/）
并发下载失败或反复卡在同一包
parallel-downloads 在 Composer 2.2+ 已弃用，正确参数是 http-max-concurrent-downloads，且只全局生效；阿里云镜像对单 IP 并发有限制，超限会返回 429。
- 设并发数：
composer config -g http-max-concurrent-downloads 8（推荐 6–12，过高触发镜像限速） - 验证是否生效：
composer config -g http-max-concurrent-downloads应输出数字，不是null - 若日志出现
zlib_decode(): data error或sha256 hash mismatch，说明缓存 ZIP 已损坏，先composer clear-cache，再加--no-cache强制跳过本地缓存 - PHP 层 socket 超时比
http-timeout更关键：临时调高php -d default_socket_timeout=600 $(which composer) install
镜像配置不是“配完就通”，关键在三处对齐：全局 config 输出正确 JSON、项目级无 repositories 覆盖、-vvv 日志里真实请求域名是你配的镜像站。任何一处错位，Composer 都会静默 fallback 到 packagist.org，然后卡住不动。
