Composer install/update 报 404 主因是包名错误、包被移除/改名、私有仓库失效、镜像未同步或 Composer 版本过低；需逐项验证 Packagist 存在性、大小写、自定义仓库 URL、镜像配置及嵌套依赖。
Composer install/update 报 404：包名拼写或命名空间错误
绝大多数情况下，composer install 或 composer update 提示远程仓库返回 404，并不是网络问题，而是包名本身不存在——要么拼错了，要么作者已重命名或删库。Composer 默认从 Packagist.org 拉取包，而 Packagist 是公开索引，不托管代码；它只记录包的元信息和源码仓库地址。一旦包被移除、私有化或改名，Packagist 就会返回 404。
快速验证方式：把报错里的包名（如 monolog/monolog）直接粘贴进浏览器访问 https://packagist.org/packages/monolog/monolog。如果打不开，说明该包在 Packagist 上已不可见。
- 检查
composer.json中"require"里每个包名，逐个在 Packagist 网站搜索确认是否存在 - 注意大小写：Packagist 包名全部小写，
Monolog/Monolog和monolog/monolog是两个不同条目（后者有效，前者 404） - 留意作者名变更：比如旧包
rmccue/requests已归档，新维护版是requests/requests，直接替换即可
私有包或 Git 仓库地址失效导致 404
如果你在 composer.json 里手动加了 repositories，指向某个 Git URL（如 GitHub/GitLab），而该仓库已被设为私有、重命名、迁移或删除，Composer 就会在尝试获取 composer.json 元数据时收到 404 —— 它默认请求的是 https://github.com/user/repo/blob/master/composer.json 或 https://gitlab.com/user/repo/raw/master/composer.json 这类路径。
- 运行
composer config --list | grep repositories查看当前配置的所有仓库源 - 对每个自定义
type: "vcs"条目，手动用curl -I测试其根 URL 是否返回 200（例如curl -I https://github.com/your-org/private-lib） - 若仓库已迁移到 GitLab 或 Gitee，需同步更新
url字段，并确认新仓库的composer.json文件存在于默认分支根目录
国内镜像源未同步，或强制跳过镜像直连 Packagist 失败
使用阿里云、腾讯云等 Composer 镜像时，偶尔会出现「镜像暂未收录该包」的情况，尤其新发布或刚改名的包。此时 Composer 会 fallback 到官方源，但如果本地配置了 "packagist.org": false 或镜像服务本身返回 404（而非 404 Not Found + fallback），就会卡死。
- 临时关闭镜像测试：运行
composer config -g repo.packagist composer https://packagist.org - 检查是否误配了
"packagist": false—— 这个配置项必须写成"packagist.org": false才生效，写错就可能导致行为异常 - 某些企业级镜像（如 Nexus Repository）需额外配置认证头或白名单，单纯换源无法解决 404
Composer 版本太老，不支持新格式的 package name 或 repository type
Composer 2.0+ 对包名校验更严格，且原生支持 artifact 和 path 类型仓库；而 Composer 1.x 在遇到新版 composer.json schema（如含 php-ext 依赖约束）或非标准仓库类型时，可能解析失败并伪装成 404。
- 执行
composer --version，确认是否低于2.2.0（当前稳定推荐版本） - 升级命令：
composer self-update（全局安装）或php composer.phar self-update（局部） - 升级后仍报 404？加
-vvv参数重试，观察日志中实际请求的 URL，比对是否因重定向失败或 Host 头缺失导致
真正棘手的 404 往往藏在嵌套依赖里：你的项目没写错包名，但某个间接依赖的 composer.json 里声明了一个已下架的子依赖。这时需要 composer why-not vendor/package 或 composer depends vendor/package 反查源头，而不是只盯着自己写的 require 列表。
