composer install在新云环境卡住主因是旧项目composer.json或lock文件仍指向原私有源，而新环境缺失对应认证、dns解析、ssh密钥或https证书；需验证私有源连通性、同步auth.json、禁用默认源并按优先级配置repositories，同时确保autoload路径与云环境目录结构一致。
为什么 composer install 在新云环境里卡住不动
不是网络差，是旧项目里的 composer.json 仍指向原私有源地址（比如内网 GitLab、自建 Satis），而新云环境没配置对应 auth 或 DNS 解析。更隐蔽的是：某些私有包在 composer.lock 里记录了完整 git URL，但新机器没 SSH key 或未启用 HTTPS 认证。
- 先验证是否能连通私有源：
curl -I https://your-private-repo.com/packages.json或git ls-remote https://git.example.com/private/pkg.git HEAD - 检查
auth.json是否同步：它默认在~/.composer/auth.json，不能靠复制项目目录带过去；CI 环境需用COMPOSER_AUTH环境变量注入 JSON 字符串 - 若私有源用了自签名证书，得在新云主机上把 CA 加进系统信任链，或临时设
composer config --global secure-http false（仅调试）
私有源地址变了，怎么让 lock 文件不报错重装
直接改 composer.lock 是危险操作——字段校验失败会导致 install 拒绝执行。正确做法是让 Composer 主动重解析依赖树，同时保留版本锁定逻辑。
- 删掉
vendor/和composer.lock，但保留原composer.json - 用
composer config repo.your-private-name composer https://new-mirror.example.com/注册新源（注意不加-g，只作用于当前项目） - 运行
composer install --no-interaction --prefer-dist，它会按composer.json重新生成lock，且所有包版本与原锁文件尽量一致（只要新源有对应版本） - 如果原私有包已下线，必须先在新源补全，或用
composer require vendor/package:dev-main --repository=https://...临时拉取
阿里云/腾讯云镜像和私有源共存时，为什么总 fallback 到 packagist.org
Composer 不会自动合并多个源，而是按顺序查，一旦某个源返回 “包不存在”，就立即转向下一个。但如果你把私有源写在 repositories 数组末尾，又没关掉 packagist.org 的自动代理，它就会优先去官方源找——结果当然是找不到你的私有包。
- 必须显式禁用默认源：
composer config repo.packagist false（项目级）或composer config -g repos.packagist false（全局） - 再把私有源和国内镜像按优先级排序写进
repositories：私有包放第一，国内镜像第二，官方源最后（可选） - 确保每个源的
url以/结尾，且type显式写成"composer"，否则 Composer 2.5+ 会跳过该条目 - 验证命令：
composer show -p | head -5，看输出的第一行是否是你期望的私有源域名
跨云迁移后 vendor/autoload.php 加载失败
常见现象是 Class not found，但 composer dump-autoload 无报错。根本原因不是类没生成，而是 PSR-4 映射路径和实际目录结构对不上——比如旧环境用 "App\": "app/"，而新云主机上 app/ 被放在了子目录，或文件权限被云平台自动重置为不可读。
- 检查
composer.json中autoload.ps4的路径是否为相对路径；如果是，确认当前工作目录就是项目根目录（pwd输出应与composer.json同级） - 运行
composer dump-autoload -v，看输出里是否列出你预期的类文件路径；如果没列，说明映射没生效 - 云主机常禁用
opcache.enable_cli=1，导致 CLI 下的 autoloader 缓存失效，但 Web 请求仍走旧缓存；重启 PHP-FPM 或执行opcache_reset() - 最稳妥的验证方式：
php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Controller\User'));"
