卡在Resolving dependencies是本地SAT求解器暴力回溯版本约束，与镜像无关；真实原因包括内存不足、Xdebug开启、platform配置错误或lock中含下线包。
composer install卡在Resolving dependencies不是镜像问题
镜像只加速下载阶段，Resolving dependencies卡住和镜像源完全无关。这个阶段是 Composer 在本地解析版本约束、计算依赖图、比对可用包版本，不发任何网络请求。常见真实原因包括：
– PHP 内存不足（默认 128M 不够，尤其 Laravel + 大量插件）；
– Xdebug 开启中（会让解析慢 5–10 倍）；
– config.platform.php 声明的 PHP 版本与实际运行环境不一致（比如声明 "php": "7.4" 却在 PHP 8.5.5 上执行，触发降级查找逻辑）；
– composer.lock 中记录了已下线或私有包，而当前镜像未同步或无权限访问。
生产环境必须用项目级镜像配置而非全局
全局配置（composer config -g）在容器化或 CI/CD 场景下极易失效：宝塔面板用 www 用户执行、Docker 容器里没加载用户级 ~/.composer/config.json、K8s Pod 启动时配置未挂载——都会导致镜像未生效。项目级配置写进 composer.json 的 repositories 字段，随代码一起部署，构建时自动读取。
正确做法：
– 进入项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/；
– 确认 composer.json 中出现 "packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；
– 若已有 repositories 字段，该命令会追加而非覆盖，避免误删私有源；
– 切勿手动编辑 JSON——一个多余逗号就会让 composer install 直接报错退出。
阿里云内网镜像在ECS上必须用HTTP协议
你在阿里云 ECS 上配 https://mirrors.aliyun.com/composer/，和没配镜像几乎一样慢。VPC 网络用户必须用：http://mirrors.cloud.aliyuncs.com/composer/（注意是 http，不是 https）；经典网络用户用：http://mirrors.aliyuncs.com/composer/。漏掉末尾斜杠 /、写成 https、或多写 /packages.json 后缀，都会导致静默失败——命令看似执行成功，但实际请求仍打向境外源。
验证是否真走内网：
– 运行：composer show laravel/framework -vvv 2>&1 | grep "Downloading"；
– 日志里必须出现 mirrors.cloud.aliyuncs.com 或 mirrors.aliyuncs.com；
– 出现 https://mirrors.aliyun.com 或 repo.packagist.org，说明配置无效。
换源后仍超时？先清缓存再重装
旧缓存里存着 packagist.org 的元数据，Composer 会优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手——不是没走镜像，是根本没发请求过去。
必须三步清干净：
– composer clear-cache；
– 删除 vendor/ 和 composer.lock；
– 执行：composer install --no-cache（禁用缓存强制走新源）。
别试图保留旧 composer.lock——它记录的是旧源的包哈希，和镜像返回的元数据不兼容，必然报 hash does not match 错误。
立即学习“PHP免费学习笔记（深入）”；
最易被忽略的是：镜像只管下载，不管解析；内网地址必须用 HTTP；缓存不清，换源等于白换。
