Composer install 报404的根本原因是包名错误、版本约束失效、仓库源不可用或包已被作者删除，而非网络问题；需依次检查包名拼写、repositories配置、缓存、私有仓库认证及真实HTTP状态码。
Composer install 报 404：包在 packagist.org 找不到
根本原因不是网络问题，而是 composer.json 里写的包名、版本约束或仓库源本身已失效。Packagist 不托管私有包，也不存档被删的旧版本。
- 先运行
composer show vendor/package-name看是否能解析出包信息；如果报错 “Package not found”，说明名字拼错、包已下架，或你用了非标准命名（比如写成laravel/framework却漏了^导致匹配不到稳定版） - 检查
composer.json中的repositories字段——如果你加了自定义源（比如 Git URL 或私有 Satis），但该源返回 404（例如 Git 仓库地址改了、权限变了），Composer 就会直接报 404，不会 fallback 到 Packagist - 运行
composer clear-cache再试一次，有时本地缓存了过期的元数据（比如包刚被删除，但你的 cache 还记着它存在）
require 的包路径 404：vendor 目录没生成或路径引用错
这不是 Composer 安装失败，而是代码里 require 或 include 了不存在的文件路径，常见于手动加载类文件、或错误假设 vendor 结构。
- 确认
vendor/autoload.php是否存在——如果composer install没跑完、中途中断、或composer.lock和composer.json不一致导致部分包没装，autoload.php就不会生成 - 别写死
vendor/some/package/src/Helper.php这种路径；Composer 自动加载靠的是 PSR-4 / PSR-0 规则，应通过use声明类，再 new 实例，而不是require物理路径 - 如果真要 require 第三方脚本（比如某些 legacy 包的
init.php），先用composer show -i vendor/package查安装路径，再拼接，别硬编码
私有包 404：GitHub/GitLab 仓库返回 404
Composer 从 Git 仓库拉取时，会把 repo_url 当作 HTTP 地址请求元数据（如 composer.json），如果仓库设为私有但没配认证，就 404。
- GitHub 私仓必须用 SSH URL（
git@github.com:org/repo.git）或带 token 的 HTTPS（https://token:x-oauth-basic@github.com/org/repo.git）；纯 HTTPS 地址（https://github.com/org/repo.git）在私仓上必 404 - GitLab 同理，确保
composer.json的repositories里 URL 是可访问的，且你本地已配置好 SSH key 或全局 Git 凭据 - 运行
composer config -g github-oauth.github.com your_token可全局授权 GitHub；GitLab 需用git config --global http.https://gitlab.com.extraheader设置 header
HTTP 404 错误里混着 401/403：Composer 把权限错误也显示成 404
这是 Composer 的一个误导性表现：当它向私有源发起请求，对方返回 401（未授权）或 403（禁止访问），Composer 日志常统一打印 “404 Not Found”，实际是鉴权失败。
- 加
-v参数重试：composer update -v，看详细日志里真实 HTTP 状态码和响应头（比如WWW-Authenticate: Basic就是缺凭据） - 用
curl -I https://your-private-repo.com/packages.json手动测源地址，观察真实状态码和Location头——如果跳转到登录页，说明需要认证 - 确认
auth.json文件位置正确（项目根目录或COMPOSER_HOME目录），且 JSON 格式合法、域名和 token 匹配
最常被忽略的是：404 提示未必指向网络或配置，而可能是 packagist.org 上那个包真的被作者删了，或者你锁定了一个只存在于 dev 分支、却没声明 "minimum-stability": "dev" 的版本。这时候看 composer show 输出比刷屏的错误更管用。
