卡在“Loading composer repositories”不是网络慢，而是Composer正扫描所有配置仓库；需用composer install -v观察末行是否停在此处，再检查repositories数组、全局配置及镜像设置。

composer install 卡在 Loading composer repositories 时怎么查

这不是网络慢，而是 Composer 正在尝试扫描所有配置的仓库（包括 repositories 里的私有源、path 类型本地包、甚至被注释掉但语法合法的条目）。它不会报错，只是一直卡住。

执行 composer install -v（不是 -vvv），观察输出最后一行是否停在 Loading composer repositories with package information。如果是，说明问题出在仓库连接环节：

• 检查 composer.json 中 repositories 数组——删掉所有非必需的私有源，尤其是 type: "package" 或未配置认证的 vcs 条目
• 运行 composer config --list | grep repos，确认没有全局配置（~/.composer/config.json）偷偷注入了不可达仓库
• 若用阿里云镜像，确保已执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；否则默认走 packagist.org，在国内常因 DNS 或 TLS 握手失败静默超时

报错 Class not found 却没提示具体类名

这通常发生在启用了 --classmap-authoritative（即 -a）但 classmap 不完整时。autoloader 直接放弃 fallback，连错误堆栈都来不及生成就 crash。

先验证 classmap 是否真包含你要的类：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 打开 vendor/composer/autoload_classmap.php，搜索类名全称（如 App\Controllers\HomeController）
• 若没找到，说明该类没被扫描进 classmap——检查它所在目录是否在 autoload 或 autoload-dev 的 PSR-4 配置中，且路径是绝对路径（$baseDir . '/src'）
• 确认该文件本身可被 PHP 解析：无 BOM、无短标签（）、无 .php.bak 后缀残留
• 临时去掉 -a 参数重跑 composer install，看是否报出具体 missing class，再反向定位缺失原因

部署后日志里出现 sh: git: not found 或 zip: not found

生产机没装 git 或 unzip，但 Composer 默认优先走 source（git clone）或需要解压 zip 包。它不会提前报错，而是在安装某个包时突然中断。

必须强制走预编译分发包并禁用所有外部命令：

• 加 --prefer-dist：跳过 git clone，直接下载 zip/tar 包
• 加 --no-scripts：防止触发依赖包自带的 post-install-cmd（比如某些包会调用 git rev-parse 获取版本）
• 确保 ext-zip 已启用（php -m | grep zip），否则即使有 zip 包也无法解压
• 若仍失败，检查 composer.lock 里对应包的 dist.type 字段——应为 zip，而非 tar 或 source

为什么 dump-autoload -v 显示扫描了路径，但类还是加载不到

composer dump-autoload -v 只告诉你“我看了这个目录”，不保证目录下所有文件都被解析。常见静默失败点：

• 文件名含大写字母但系统是大小写不敏感的（如 macOS / Windows）：类 FooBar.php 声明 class foobar，PSR-4 规则会匹配失败
• 命名空间声明与目录结构不一致：例如 "App\": "src/"，但 src/Controllers/HomeController.php 里写的是 namespace AppControllers; ✅，若写成 namespace Appcontroller; ❌（小写 c）则不会映射
• autoload 和 autoload-dev 混用：生产环境跑 --no-dev，但把测试工具类写在顶层 autoload 里，导致 classmap 里塞了本不该存在的路径，运行时 stat() 失败又不报错
• 最终映射路径是否真实存在？vendor/composer/autoload_psr4.php 里看到的是 $baseDir . '/src'，手动执行 php -r "echo __DIR__ . '/src';" 看输出路径，再 ls -l 确认该路径下真有文件

关键不在“有没有报错”，而在“有没有被真正纳入加载路径”。很多问题藏在 classmap 生成逻辑和文件系统行为的交界处，得一层层剥开看。