composer报404主因是包名错误、镜像地址缺斜杠、composer.lock锁定失效url、私有包配置不当；需查packagist页面、验证镜像末尾斜杠、删lock文件重装、前置repositories并声明type。
包名拼错或已废弃，Packagist 页面是唯一真相
Composer 报 404 Not Found，八成不是网络问题，而是你写的包名根本不存在——或者它已经改名、归档、停更。IDE 补全、旧文档、甚至 Stack Overflow 上的代码都可能缓存了过时的包名。
直接打开 https://packagist.org/packages/你的vendor/你的package（把 你的vendor/你的package 替换成实际值），看页面是否返回 404：
- 如果页面打不开，说明包名写错，比如
guzzle/guzzle（旧名）应为guzzlehttp/guzzle - 如果页面能开，点 “Versions” 标签，确认你要的版本（如
^7.9或dev-main）是否列在其中；dev-master已被大量项目弃用 - 注意大小写：Composer 区分大小写，
Monolog/monolog≠monolog/monolog
镜像源地址漏斜杠、用错域名，curl -I 是最快验证方式
composer config -g repo.packagist 输出的 URL 必须带末尾 /，否则所有 p2/ 路径请求都会 404。国内用户最常踩的坑是把 https://mirrors.aliyun.com/composer 当成有效地址，其实它必须是 https://mirrors.aliyun.com/composer/（末尾斜杠不能少）。
别信配置输出就完事，手动测通才是关键：
- 运行
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回HTTP/2 200才算活 - 返回
404或超时，说明镜像已下线（如packagist.phpcomposer.com自 2022 年起持续返回 404）或被本地网络拦截 - 已停用的旧镜像包括：
packagist.laravel-china.org、packagist.phpcomposer.com，立刻换掉
composer.lock 硬编码旧 provider 地址，删它比清缓存更重要
换了镜像、清了缓存还是 404？大概率是 composer.lock 里锁死了失效的原始 URL，比如 https://packagist.org/p2/monolog/monolog.json 或已失效的 GitHub API 地址。Composer 会优先尝试 lock 文件里的路径，而不是你新配的镜像。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须执行以下三步，缺一不可：
- 先运行
composer clear-cache（清除 provider 缓存） - 再删除
vendor/和composer.lock（尤其composer.lock是罪魁） - 最后执行
composer install（不要用update，它会复用 lock 里坏掉的元数据）
私有包没声明 type 或排位错误，repositories 配置必须前置
如果你 require 的是公司内部包、GitHub 私有库或 Satis 源，但 composer.json 里只写了 url 没写 type，或者 repositories 块排在镜像之后，Composer 就会 fallback 到 packagist 找包——自然 404。
正确写法要满足两个硬性条件：
- Git 包必须明确指定
"type": "git"，且url是可 clone 的地址，例如"https://github.com/your-org/your-package.git" - 私有 Packagist 类型源（如 Satis）必须写
"type": "composer"，且该服务本身可访问、已包含目标包 -
repositories块必须放在composer.json顶层，且私有源要排在镜像配置之前，否则不生效
真正容易被忽略的是 composer.lock 的顽固性——它不像缓存那样能被 clear-cache 清掉，一旦锁住一个已下线的 provider 地址，就算你切回官方源、换十次镜像，它都照报 404。
