Composer报404主因是包不在当前源中，包括镜像未同步、官方源被墙、私有包未配置repositories或认证失败；可通过composer show、config -g和访问packagist.org验证。
为什么 composer install 报 404：包不存在或源不可达
Composer 报 404，绝大多数情况不是你写错了包名，而是它根本没在当前配置的仓库里找到那个包——要么包真不存在，要么你连的是镜像源但镜像没同步、或已下线，又或者你用了私有包但没配好认证。
-
composer.json里写的包名拼错（比如"monolog/monolg"少了个o），会直接 404 - 国内用阿里、腾讯等镜像源时，某些新发布包（尤其是 dev 分支或刚提交的 tag）可能还没同步，
composer clear-cache && composer install也无效 - 访问 packagist.org 被墙，而你又没设镜像，Composer 默认会 fallback 到官方源，结果超时后报 404（实际是网络失败伪装成 404）
- 私有 Git 包（如
"myorg/mylib": "dev-main"）没在repositories里声明类型和 URL，Composer 就当它不存在
怎么快速确认是源问题还是包问题
别急着删 vendor 或重装 Composer，先用 composer show 和 composer config -g repo.packagist 快速定位。
- 运行
composer show -a <vendor/name>（例如composer show -a laravel/framework），如果返回空或“Package not found”，说明当前源里真没有这个包 - 执行
composer config -g repo.packagist查看全局镜像设置；如果是{"url":"https://packagist.phpcomposer.com"}这类已停用的旧镜像，立刻换掉 - 临时切回官方源验证：
composer config -g repo.packagist '{"url":"https://packagist.org","type":"composer"}，再试composer show - 想查某个包是否真存在且可安装？直接打开浏览器访问
https://packagist.org/packages/<vendor/name>（如https://packagist.org/packages/doctrine/orm）
私有包 404 的典型修复步骤
私有包报 404，90% 是 repositories 配置漏了关键字段，或 Git 服务本身拒绝未认证访问。
- 确保
composer.json的repositories区块包含完整类型和 URL，例如 GitLab 私有库要写成："repositories": [ { "type": "vcs", "url": "https://gitlab.example.com/mygroup/mylib.git" } ] - 如果 Git 仓库需要 token 认证（如 GitHub private repo），不能只靠
auth.json—— 还得确保 token 有read:packages权限，并且 URL 里不带@用户名（否则 Composer 会忽略auth.json） - Git 标签或分支名必须真实存在，
"dev-my-feature"要求远程 Git 有对应 branch；"1.2.3"要求有对应 tag。用git ls-remote <repo-url>手动核对 - 私有包若依赖其他私有包，所有依赖项都得在同一个
repositories列表里声明，Composer 不会递归查找
镜像源失效或不同步时的应急方案
阿里云、华为云等镜像偶尔滞后或临时不可用，这时候硬等不如手动干预。
- 临时禁用镜像，强制走官方源：
composer config -g repo.packagist false，之后命令会自动 fallback 到https://packagist.org - 换一个更稳定的镜像，比如清华源：
composer config -g repo.packagist '{"url":"https://packagist.phpcomposer.com","type":"composer"}→ 改为https://packagist.mirrors.ustc.edu.cn - 如果只是某个包缺失，但你知道它在 GitHub 上有公开 repo，可以临时加
vcs源绕过 Packagist："repositories": [ { "type": "vcs", "url": "https://github.com/someuser/somepackage.git" } ] - 注意：改完
repositories后，必须运行composer update --lock（不是install），否则composer.lock还记着旧源地址，依然 404
最常被忽略的一点：Composer 的 404 错误信息里往往混着真实原因和伪装错误。比如网络超时、DNS 解析失败、SSL 证书异常，都会被统一打印成 “Could not find package … in a version installable using your PHP version, PHP extensions and Composer version” 或干脆只有 “404 Not Found”。遇到这种模糊提示，优先检查网络连通性、镜像状态、以及 composer diagnose 输出的真实连通性报告。
