Composer报404主因是源配置错误、缓存锁死失效URL或SSL证书过期；应先用composer config -g repo.packagist查源，换有效镜像（如清华源），清缓存、删vendor与lock后重装，并验证CA证书。
Composer 报 404，90% 不是包名写错，而是它根本没在你当前连的源里找到那个包——可能是镜像已下线、私有仓库没配 type、缓存锁死了失效 URL，或证书校验失败后被误判成 404。
怎么看当前用的是哪个源？
别猜，直接查配置。运行 composer config -g repo.packagist，输出类似 {"url":"https://packagist.phpcomposer.com"} 就是问题根源：这个地址自 2022 年起已返回 404，必须换掉。
- 清华源（推荐）：
composer config -g repo.packagist composer https://packagist.proxy.fly.dev - 阿里云源（注意末尾斜杠）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 切回官方源验证（需境外网络）：
composer config -g repo.packagist composer https://repo.packagist.org
改完立刻执行 composer config -g repo.packagist 确认输出已更新，不是 null 或旧地址。
怎么确认是包真不存在，还是源没同步？
用 composer show -p vendor/name（比如 composer show -p monolog/monolog），如果返回空或 “Package not found”，说明当前源里压根没这个包。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 打开浏览器访问
https://packagist.org/packages/vendor/name，看网页是否能打开、版本列表是否包含你要的版本（注意大小写） - 如果是私有 Git 包，
composer show -p必定为空——它只查 Packagist 公库，不查你本地repositories - 镜像不代理私有源，
repositories里的type: vcs地址出 404，和镜像无关，得单独排查 Git 服务本身
为什么清了缓存、换了源还是 404？
因为 composer.lock 里存的是原始下载地址（比如 GitHub API 的 URL），不是镜像地址。一旦锁文件里记了一个已失效的 provider 路径，换源也白搭。
- 第一步永远是
composer clear-cache - 删掉
vendor/和composer.lock（尤其 lock 文件） - 再跑
composer install，不要用update—— 它会复用 lock 里可能已坏的元数据 - 如果用了自定义
repositories，逐个注释掉，确认是不是其中某个 URL 返回 404
SSL 证书过期也会伪装成 404
PHP cURL 握手失败时，Composer 常把空响应误报为 404 或 500。运行 php -r "print_r(openssl_get_cert_locations());" 查看 default_cert_file 路径，检查该 PEM 文件是否存在、最后修改时间是否早于 2023 年。
- 临时验证：设
composer config -g secure-http false，再试一次；若成功，就是证书问题 - 生产环境必须修复：更新系统 CA 包，或把新 PEM 路径写进
php.ini的curl.cainfo和openssl.cafile - Docker 用户注意：alpine 镜像默认不带完整 CA，需
apk add ca-certificates并确保/etc/ssl/certs/ca-certificates.crt可读
最常被忽略的是 composer.lock 里埋的失效 URL 和 OpenSSL 证书陈旧——这两处不处理，换十次镜像都没用。
