包名拼写或大小写错误、镜像源未同步或失效、私有/新发布包未正确提交至packagist、minimum-stability限制非stable版本，是导致composer报“could not find package”四大主因。
包名拼写或大小写错误导致404
Composer 严格匹配 Packagist 注册的完整包名，monolog/monolog 和 Monolog/Monolog 是两个完全不同的包，后者直接报 Could not find package Monolog/Monolog。很多“找不到”根本不是网络或镜像问题，而是本地输错了。
- 打开 https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0，把你要装的包名完整粘进去搜索，确认是否返回有效页面
- 检查命令里有没有漏掉
vendor前缀，比如把phpunit/phpunit写成phpunit - 别从网页或聊天记录里直接复制包名——里面可能藏了不可见空格或全角字符，建议在纯文本编辑器里重打一遍再粘贴
镜像源未同步或已失效
国内主流镜像（如阿里云、腾讯云）对 Packagist 的元数据同步存在延迟，冷门包可能数小时不更新；更常见的是 Laravel China 镜像已于 2023 年底停用，但项目里还留着配置，一查就 404。
- 运行
composer config --list | grep repo.packagist确认当前生效源地址（注意结尾斜杠） - 临时切回官方源验证：
composer config -g repo.packagist composer https://repo.packagist.org - 若确认是镜像延迟，手动删元数据缓存目录：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（Windows 路径为%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer） - 删完立刻跑
composer show vendor/package，强制重拉最新索引
私有包或新发布包未进 Packagist
GitHub 上点下 release ≠ Composer 能立刻装到。Packagist 不自动爬取所有仓库，必须手动提交或配好 webhook；私有包则必须在 composer.json 的 repositories 字段显式声明源类型和 URL。
- 新包刚发，去 https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0submit 提交 GitHub/GitLab 仓库 URL
- 提交后进该包的 Packagist 页面 → Edit → 开启 Update on Push（即 webhook）
- 确保 Git tag 是
v1.0.0或1.0.0，不能是release-1.0、v1.0_final等非标准格式 - 私有包必须配
repositories，且type明确为vcs，否则 Composer 根本不会往你指定的 Git 地址去查
minimum-stability 锁死非 stable 版本
默认 "minimum-stability": "stable" 会过滤掉所有 dev-、beta、rc 版本。你搜得到包，composer search 也能命中，但 require 就报 could not find a matching version。
- 先运行
composer show vendor/package，看是否已有旧版本，新版本是否被稳定性策略屏蔽 - 临时允许安装开发版：
composer require vendor/package --stability=dev --prefer-source - 不推荐长期改全局
minimum-stability到dev，容易引发其他依赖升级失控；更安全的做法是只对单个包放宽："require": { "vendor/package": "dev-main as 1.0.0" }
composer show 和 curl -I 验证，比反复 clear-cache 有用得多。
