装高版本laravel失败主因是镜像同步延迟与缓存复用：composer复用本地过期packages.json缓存，而阿里云/腾讯云镜像通常滞后5–30分钟；需验证镜像元数据接口、执行composer update --refresh（≥2.5）或临时指定--repository参数绕过。
装高版本 Laravel（比如 laravel/framework:^11.0）失败，不是 Laravel 本身不兼容，而是你本地 Composer 拿着过期的 packages.json 缓存去查中文镜像，而镜像站还没同步到新版本——它根本没在索引里，自然“找不到包”。
为什么 composer create-project laravel/laravel 找不到 v11？
现象是报错 Could not find package laravel/laravel with version ^11.0 或 Nothing to install or update，但你在 packagist.org 上明明看到已发布。这不是镜像“坏了”，是 Composer 默认复用本地缓存的 packages.json（15 分钟内不过期），哪怕镜像站已更新，它也不发请求。
-
composer clear-cache不解决：它清的是 ZIP 包和部分 JSON，packages.json缓存会立刻重建并复用旧数据 - 改了
repo.packagist配置也不行：如果项目级composer.json里有"repositories"字段，它会彻底屏蔽全局设置，且不提示 - 镜像同步本身有延迟：阿里云/腾讯云镜像通常滞后 5–30 分钟；新包发布后一小时内查不到是常态
验证当前镜像是否真包含你要的版本
别信网页界面或 composer diag——它默认只测官方源。必须直接查镜像元数据接口：
- 先确认生效镜像：
composer config -g repos.packagist.url（注意是复数repos，Composer 2.2+ 要求） - 查全量索引是否更新：
curl -I https://mirrors.cloud.tencent.com/composer/packages.json，必须返回HTTP/2 200 - 查具体包是否存在：
curl -s https://mirrors.cloud.tencent.com/composer/p2/laravel/framework.json | jq -r '.packages."laravel/framework" | keys[]' | sort | tail -3 - 对比官方源输出：
curl -s https://packagist.org/p2/laravel/framework.json | jq -r '.packages."laravel/framework" | keys[]' | sort | tail -3，若版本不一致，就是同步延迟
composer update --refresh 是唯一精准解法（仅 ≥2.5）
它只丢弃 packages.json 和 provider-*.json，保留已下载的 ZIP 包，快且安全。但执行前必须确认两件事：
-
composer config -g repo.packagist输出是你期望的镜像地址（如https://mirrors.cloud.tencent.com/composer/），末尾/不能少 - 当前项目根目录下
composer.json中没有"repositories"字段，否则--refresh也会去错地方拉 - 老版本（≤2.4）不支持该参数，只能手动删缓存子目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-cloud-tencent-com-composer
临时绕过镜像延迟的实操方案
如果等不及同步，又不想切回官方源（怕慢），可临时指定镜像 URL 创建项目：
- 加
--repository参数强制走新镜像：composer create-project --repository=https://mirrors.cloud.tencent.com/composer/ laravel/laravel myapp - 加
--prefer-dist避免 Git 克隆失败：composer create-project --prefer-dist --repository=https://mirrors.cloud.tencent.com/composer/ laravel/laravel myapp - 若仍失败，说明镜像确实没同步，此时最稳做法是临时切回官方源：
composer config -g --unset repos.packagist，再运行安装命令
真正容易被忽略的点是：项目级 repositories 配置会静默屏蔽全局镜像，且 composer config -g 看起来成功了，不代表它真在用——得看 composer install -vvv 日志里实际发起的请求 URL。
