最常见原因是包名输错或大小写不符;Composer严格匹配Packagist注册的完整包名,如monolog/monolog与Monolog/Monolog被视为不同包,后者直接404。
包名输错或大小写不对,是“找不到”最常踩的坑
Composer 不是模糊搜索,它严格比对 Packagist 上注册的完整包名,
和
是两个不同包,后者直接 404。很多报错其实根本没连上网络,只是本地拼错了。
打开
https://www.php.cn/link/6daab15a4f57549b7f236d7f0cfca3c8
,把你要装的包名完整粘进去,看是否返回有效页面
检查命令里有没有漏掉 vendor 前缀,比如把
写成
别从网页或聊天记录里直接复制包名——里面可能藏了不可见空格或全角字符,建议在纯文本编辑器里重打一遍再粘贴
新包刚发,Packagist 还没索引,不是你网络问题
GitHub 上点下 release 按钮 ≠ Composer 能立刻装到。Packagist 不会自动爬取所有仓库,必须手动提交或配好 webhook 才能进库。你刷新八遍搜索页,它就是不出现,因为压根不在库里。
去
packagist.org
右上角点
Submit
,填入 GitHub/GitLab 仓库 URL 提交
提交后进入该包的 Packagist 页面 → 点
Edit
→ 开启
Update on Push
(即配置 webhook)
如果已提交但没生效,点页面上的
Force update
按钮(仅对已关联包可见)
确保你的 Git tag 是
或
,不能是
、
或带空格/下划线
用了国内镜像,但新包或私有分支根本没同步
阿里云、腾讯云等镜像不是实时全量同步,尤其对刚发布的包、dev 分支、或已被下架的包,极易返回
。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化,改进了依赖解析算法,提升大型项目中的安装与更新速度。它支持并行下载任务,显著减少等待时间,并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷,确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护,Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
运行
查当前源
临时切回官方源验证:
确认 Laravel China 镜像(
)已于 2023 年底停用,还在用必 404
换源后务必执行
,否则旧缓存会继续指向失效地址
私有包、本地开发包没配 repositories,Composer 根本不往那儿找
Composer 默认只查 Packagist,你指了
,但它既没上 Packagist,又没告诉 Composer “去我公司 GitLab 或本地文件夹里翻”,那它当然报“not found”。
GitHub 公开仓库(未提交 Packagist):在项目
中加
段:
本地调试路径:
装的时候用具体分支或 tag,比如
(注意分支名要和 GitHub 默认分支一致)
别忘了删掉
和
,再跑
,否则 lock 文件可能锁死一个旧的、无效的 provider 地址
事情说清了就结束。真正卡住的往往不是语法或命令,而是以为“发布即可见”,结果在 Packagist 页面刷新了八遍才发现根本没进它的库。手动提交 + 开启 webhook 是一劳永逸的起点,别跳过这步。
monolog/monologMonolog/Monologphpunit/phpunitphpunitv1.0.01.0.0release-1.0v1.0_finalThe "https://mirrors.aliyun.com/composer/p/provider-2025-10%24json" file could not be downloaded (HTTP/1.1 404 Not Found)composer config --list | grep repo.packagistcomposer config -g repo.packagist composer https://repo.packagist.orgpackagist.laravel-china.orgcomposer clear-cachemyorg/my-private-packagecomposer.json"repositories"{"type": "vcs", "url": "https://github.com/myorg/my-private-package"}{"type": "path", "url": "../my-local-package"}composer require myorg/my-private-package:dev-mainvendor/composer.lockcomposer install