404 错误主因是镜像未同步、url 配置错误或 composer.lock 硬编码旧地址；需用 composer show -p 和 packagist 官网比对包存在性，检查镜像 url 末尾斜杠、清缓存并重装依赖，排除私有包配置与 ssl 证书问题。
404 不是包丢了，而是你请求的 URL 根本不存在——大概率是镜像没同步新包，或地址本身写错了。
怎么确认是镜像不同步，而不是包名写错
先别删 vendor，用 composer show -p vendor/package 查当前源里有没有这个包。如果返回空或 “Package not found”，再打开浏览器访问 https://packagist.org/packages/vendor/package —— 页面能打开，说明包存在；点进 “Versions” 标签，确认你要的版本（比如 ^8.2 或 dev-main）是否列在其中。如果官方页面有、但 composer show -p 没，基本就是镜像没同步。
- 镜像同步有延迟：新发布的 tag 或 dev 分支，阿里云/腾讯云镜像通常要 5–30 分钟才可见
- 私有包、GitHub 直连包（
"type": "vcs"）完全不走镜像，composer show -p必定为空 - IDE 自动补全可能缓存旧包名（如
guzzle/guzzle），别信，手动核对官网页面
镜像地址末尾缺 / 就会 404
运行 composer config -g repo.packagist，输出必须是带末尾斜杠的完整 URL，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。少一个 /，请求路径就会变成 https://mirrors.aliyun.com/composer/p2/monolog/monolog.json（404），而不是正确的 https://mirrors.aliyun.com/composer/p2/monolog/monolog.json。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 已停用的旧镜像（如
https://packagist.phpcomposer.com）自 2022 年起固定返回 404，必须立刻换掉 - 手动验证镜像是否存活：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回HTTP/2 200 - 清华源推荐用
https://packagist.proxy.fly.dev，不是tuna.tsinghua.edu.cn那个（后者需额外配置代理）
为什么清了缓存、换了镜像还是 404
因为 composer.lock 里硬编码了旧 provider 地址（比如 https://packagist.org/p2/monolog/monolog.json），换源后 Composer 仍优先尝试这个链接。它不会自动把锁文件里的地址替换成镜像地址。
- 必须删掉
vendor/和composer.lock（尤其后者），再跑composer install - 不要用
composer update，它会复用 lock 文件里已失效的元数据 -
composer clear-cache是必要前置动作，但单独执行无法解决 lock 文件导致的 404 - 若用了自定义
repositories，逐个注释掉再试，避免某个私有 Git URL 返回 404 污染整个流程
SSL 证书过期也会伪装成 404
PHP cURL 握手失败时，常把空响应误报为 404 或 500，尤其在 Docker Alpine、老旧 CentOS 或 OpenSSL 版本太低的环境。
- 运行
php -r "print_r(openssl_get_cert_locations());"查看default_cert_file路径 - 检查该 PEM 文件是否存在、是否为空、最后修改时间是否早于 2023 年
- 临时验证：执行
composer config -g secure-http false，再试一次；若成功，就是证书问题 - 生产环境务必修复：更新 CA 包，或在
php.ini中设置curl.cainfo和openssl.cafile
最常被忽略的三处：镜像 URL 末尾斜杠、composer.lock 的硬编码路径、私有包漏写 "type": "vcs" 导致 fallback 到镜像找包——现象一样，根因完全不同。
