“Could not find package”主因是镜像未生效、本地元数据缓存过期或项目级repositories覆盖全局配置；应验证composer config -g repos.packagist输出、检查项目composer.json中repositories字段、删除对应缓存子目录并curl镜像URL确认同步状态。
报“Could not find package”先查镜像是否真生效
这个错误几乎从不表示包真的不存在，而是 Composer 没读到最新元数据——大概率是你配的镜像根本没起作用。很多人改完 composer config -g repo.packagist 就跑命令，结果日志里还是出现 Downloading https://packagist.org/。
必须验证三件事：
-
composer config -g repos.packagist（注意是复数repos）输出必须是完整 JSON，如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；空或报错说明全局配置失败 - 项目根目录若有
composer.json且含"repositories"字段（哪怕只是[]），就会**完全屏蔽**全局镜像；此时要查composer config repo.packagist（不加-g） - 旧模板残留的
"url": "https://packagist.phpcomposer.com"已停用，会导致 404 卡死，得手动删掉
“file could not be downloaded”别急着重装，先切镜像+清缓存
国内用户遇到下载失败、卡在 Loading composer repositories 或 Content-Length mismatch，90% 是网络链路问题，不是本地坏了。Packagist.org 直连在国内基本不可靠。
两步必须一起做：
- 立刻切阿里云镜像：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ - 切完必须清缓存：
composer clear-cache；否则旧失败记录还在，重试照样失败
如果还卡，再检查 cache-files-maxsize 是否太小：composer config -l | grep cache-files-maxsize，建议设为 1024MiB：composer config --global cache-files-maxsize 1024MiB。
依赖冲突报“Your requirements could not be resolved”别碰网络设置
这个错误说明 Composer 已经拿到所有包元数据，但在本地求解时找不到满足全部约束的版本组合——它不怪镜像、不怪网速，只怪约束之间打架了。
直接定位拦路包：
- 运行
composer why-not php:8.3（把8.3换成你目标版本），看哪个包锁死了低版本 PHP - 检查
composer.json里有没有写死版本号，例如"monolog/monolog": "2.9.0"，而新包要求^3.0，两者无交集 - 确认 CLI 真实环境：
php -v和php -m | grep -E "mbstring|openssl|curl|json"，Web 和 CLI 可能加载不同php.ini
composer install --ignore-platform-reqs 只是掩盖问题，上线前必须让代码真兼容目标环境。
404 Not Found 错误要分清是全局还是个别包
404 不等于包没了，而是 Composer 找不到它——可能拼错名、源没同步、或包本身不在 stable 分支。
快速判断路径：
- 访问
https://packagist.org/packages/xxx（把xxx换成包名）确认是否存在；若页面 404，就是真没了或名字错了 - 若页面存在但 Composer 报 404，检查是否用了
--stability=dev——默认只查 stable 版本 - 私有包？确认
repositories配置正确，且github-oauth.github.comToken 有效；用curl -I测试仓库 URL 是否可访问
最易被忽略的是：镜像站网页显示 v3.6.0 ≠ p2 接口已同步。最准的方式是比对元数据接口：curl -s https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3，和官方源对比是否一致。
