“package not found”报错大概率是因国内镜像同步滞后或漏同步，可临时用--repository=https://packagist.org绕过镜像直连官方源，或通过--repository=packagist禁用所有镜像；建议检查镜像同步时间、按需切换镜像源，并避免在ci/cd中硬编码镜像配置。
Composer install 报错 “Package not found” 但包明明存在
这大概率不是包真不存在，而是你用了国内镜像（比如阿里云、腾讯云、华为云），但镜像同步滞后或漏同步——尤其新发布的小版本、dev 分支、私有包，或者 packagist.org 刚收录几小时内的包。Composer 默认只查镜像，不回源，所以 composer install 直接失败。
临时绕过镜像，强制走 packagist.org
最直接的解法是让当前命令跳过镜像，直连官方源。不需要改全局配置，也不影响后续操作：
- 加
--repository=https://packagist.org参数：composer install --repository=https://packagist.org - 或者更彻底地禁用所有镜像（包括 config 中设的）：
composer install --no-plugins --no-scripts --repository=packagist
注意：--repository=packagist 是 Composer 内置的 shorthand，等价于 --repository=https://packagist.org，但比手敲 URL 少出错。
检查镜像状态与切换策略
别盲目切源。先确认是不是镜像问题：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 打开镜像首页（如
https://mirrors.aliyun.com/composer/），看页面底部有没有“Last synced”时间，如果超过 2 小时，基本可判定滞后 - 用
composer config --list | grep repo查当前生效的仓库配置 - 想临时换另一个镜像（比如从阿里云切到腾讯云）：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
不同镜像同步节奏差异大：阿里云通常 10–30 分钟，腾讯云有时卡 1–2 小时，华为云对 dev 分支支持偏弱——选哪个得看你要装的包类型。
长期项目建议：不要全依赖单一镜像
镜像本质是缓存，缓存就一定有失效窗口。生产环境 CI/CD 或团队协作时，硬编码镜像反而增加不确定性：
- CI 脚本里避免写死
composer config repo.packagist ...，改用COMPOSER_REPO_PACKAGIST=https://packagist.org环境变量覆盖 - 私有包或内部组件，直接在
composer.json的repositories字段声明具体 URL，不走镜像 - 如果必须用镜像，定期跑
composer show vendor/package version验证关键依赖能否解析，比等install报错更早发现问题
镜像不是银弹，它加速的是「已同步」的包。刚发布的 tag、带 commit hash 的 dev 版本、甚至某些小众组织下的包，packagist.org 自身都可能要几分钟才索引完成——这时候连官方源都会短暂 404，更别说镜像了。
