composer install卡在resolving dependencies是本地sat求解器暴力穷举版本组合，非网络问题；应运行composer update --dry-run -vvv定位卡点，用composer why-not直击阻断链，换镜像、调超时、清缓存均无效。
配镜像源本身不加速“发布”，只加速“下载”——组件迭代发布慢，90% 不是镜像问题，而是本地解析卡住、私有源超时或 lock 文件冲突。
composer install 卡在 Resolving dependencies 怎么办
这个阶段完全不走网络，镜像再快也没用。Composer 正在本地穷举满足所有约束的版本组合，常见诱因包括：
-
composer.json里写了太宽的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3"，求解器要试几百种组合 - 存在
"minimum-stability": "dev"，强制拉dev-分支，候选包数量指数级膨胀 -
composer.lock被删或未提交，install实际退化为update，触发全量重解析 - 项目
repositories字段里配置了已下线或响应超时的私有源，Composer 会逐个等待 timeout 后才 fallback
验证是否卡在这步：加 -vvv 运行 composer install -vvv，盯紧日志里是否有长时间停留的 Resolving dependencies through SAT。
镜像配置写对但还是走 packagist.org
90% 的“配了没用”是命令输错，且 Composer 静默 fallback，不报错也不提示。必须检查这三点：
- 键名必须是
repo.packagist—— 写成repos.packagist（多一个 s）、packagist（少repo.）、mirror（官方不识别）都无效 - 中间那个
composer是type值，不能省：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（缺斜杠会拼出 404 路径）
验证方式唯一可靠：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或明确 URL 字符串。空、null、或仍是 https://packagist.org，说明根本没写进去。
Docker 构建中镜像源不生效
容器内默认不读宿主机的全局配置，你在本地配的 repo.packagist 对构建过程零影响。必须把镜像源“写进构建流程”：
- 在
Dockerfile的RUN composer install前插入：RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - 或者更推荐：直接用参数指定，语义清晰且可复现 ——
RUN composer install --repository=https://mirrors.aliyun.com/composer/ - 别忘了分层缓存：确保
COPY composer.json composer.lock ./在RUN composer install之前，且位置靠前；否则任意代码改动都会让依赖安装层失效
还有一个易忽略点：如果 composer.lock 里锁的是 GitHub git 地址（比如 "type": "package" 或私有 fork），Composer 仍会直连 GitHub 下载 ZIP，绕过镜像源 —— 这类依赖需单独处理，不能只指望换源。
宝塔、CI、计划任务里镜像不生效
全局配置写在 /root/.composer/config.json，但它只对 root 用户生效。而宝塔「PHP 管理器」、「一键部署」、计划任务默认以 www 用户运行；GitHub Actions 用 runner 用户；它们根本读不到 root 的配置。
解决方法很直接：先确认实际执行用户（比如在宝塔终端里运行 whoami），再针对性配置：
- 给
www用户配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中确保
composer config -g和后续composer install是同一用户上下文
别信 sudo composer config -g 写进 root 配置后普通用户就能自动继承 —— Composer 不做跨用户配置共享，这是权限隔离的正常行为。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
