Composer install报错“Could not find package xxx”主因是镜像元数据同步延迟或本地缓存过期；需先执行composer clear-cache清缓存，再用composer update --dry-run验证，若仍失败则检查当前生效镜像源（优先级：项目级repositories＞全局配置＞默认源），确认是否被覆盖或已停更，并通过curl -I验证镜像同步状态。
Composer install 报错 Could not find package xxx 怎么办？
不是包不存在，也不是你拼错了名字，大概率是 Composer 缓存了过期的镜像元数据，导致它查不到新发布的版本或刚注册的包。国内用户尤其常见——因为用了镜像源（如阿里云、腾讯云），而镜像同步有延迟，且本地缓存没及时更新。
直接执行：
composer clear-cache，清掉本地所有缓存文件；再运行：
composer update --dry-run（先试跑不真正安装）观察是否能解析到目标版本。如果还失败，说明镜像源本身还没同步，得换源或等几小时。
怎么确认当前用的是哪个镜像源？
Composer 不会自动告诉你正在用哪个镜像，但它的行为完全由 composer.json 里的 repositories 配置或全局配置决定。优先级从高到低：项目级 repositories > 全局 config（composer config -g repo.packagist）> 默认官方源。
检查方式：
composer config -g repo.packagist查全局镜像；
composer config repo.packagist查当前项目是否覆盖了源。常见错误是项目里写了
"https://mirrors.aliyun.com/composer/"，但该镜像上周刚停更某类包（比如私有包或 dev 分支），而你恰好依赖那个分支。
为什么 composer require xxx:dev-main 找不到？
因为镜像源默认只同步 stable 版本（1.0.0、2.3.4 这类），dev-main、dev-develop 这类开发分支通常被跳过。即使包存在，镜像也不会拉取其 composer.json 的完整信息。
临时解决办法：
- 加
--prefer-source强制走 Git 克隆，绕过镜像元数据 - 删掉
repositories配置，切回官方源（composer config -g repo.packagist https://packagist.org）再试 - 确认该包在 Packagist 页面上确实标记为 “Public” 且未被作者设为 private
--prefer-source 会显著拖慢安装速度，仅用于调试。
刷新镜像缓存后仍失败，下一步看什么？
重点看 composer show xxx 的输出——如果返回空，说明包名根本没被索引；如果返回版本列表但缺你要的，说明镜像同步滞后或包作者没 push tag。别急着重装 Composer 或怀疑网络，先跑：
composer diagnose检查 SSL、CA 证书、DNS 是否正常；再手动 curl 镜像源地址（比如
curl -I https://mirrors.aliyun.com/composer/p2/xxx.json），看 HTTP 状态码是不是 404。404 就坐等镜像同步，503 就换源。
最常被忽略的一点：某些企业私有包必须通过 composer config repositories.xxx 显式声明，不能靠镜像源代理——哪怕你把镜像源设成官方，也得单独配私有仓库地址。
