Composer install 失败的真实原因是镜像配置错误、权限问题或网络连通性故障，而非自动加载失败；运行时报 Class not found 才是 autoload 问题，需检查 PSR-4 配置、命名空间路径一致性及 classmap 是否包含该类。
自动加载失败本身不会让 composer install 报错，它只影响后续 PHP 运行时类找不到；真正让 composer install 失败的，是镜像配置错误、权限问题或网络连通性故障——但很多人误把运行时报的 Class not found 当成 install 阶段失败。
为什么 composer install 会卡在 “Loading composer repositories”
这不是自动加载问题，而是 Composer 根本没连上源。常见真实原因：
-
composer config -g repo.packagist输出仍是https://packagist.org？说明镜像没配对：键名必须是repo.packagist（不是repos.packagist），type必须显式设为composer，URL 必须 HTTPS 且末尾带/ - 换源后没清缓存：
composer clear-cache必须执行，否则旧失败记录还在，重试仍走原地址 - DNS 解析失败：运行
ping packagist.org看是否返回unknown host；企业内网若走 HTTPS 解密代理（如 Zscaler），会静默触发 TLS 握手失败 - PHP 的
openssl.cafile或curl.cainfo指向过期 CA 证书（比如停更于 2021 年的curl-ca-bundle.crt）；应下载最新cacert.pem并统一配置
composer install 成功但运行时报 Class not found 怎么办
这是典型的 autoload 配置或生成失效，不是 install 阶段的问题。关键检查点：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认
composer.json中autoload的 PSR-4 前缀末尾有反斜杠："App\": "app/"✅，"App": "app/"❌（缺转义，实际变成"App"） - 新增类文件后，命名空间必须与路径严格对应：比如
app/Console/Commands/DeployCommand.php的命名空间必须是namespace AppConsoleCommands;，不能漏掉Console分隔符 - 别把
tests/或examples/路径塞进autoload（应放autoload-dev），否则 classmap 会膨胀且污染生产映射 - 验证
vendor/composer/autoload_classmap.php是否真包含你的类：搜索全名AppConsoleCommandsDeployCommand，不在里面就说明扫描失败
生产环境该用哪个命令优化自动加载
只有一条命令真正生效：composer install --no-dev --optimize-autoloader --classmap-authoritative。其他组合基本无效：
-
composer dump-autoload -o在 Composer 2.x + PHP 7.4+ 下只是--classmap-authoritative的别名，不重建autoload_classmap.php，也不扫描新类，classmap 常为空或漏项 -
"optimize-autoloader": true写在composer.json里不会自动触发任何动作，它只是个默认开关 -
--no-dev不仅删 dev 包，还让 Composer 完全忽略它们的 autoload 规则，避免测试类混进 classmap -
--classmap-authoritative不是“加速开关”，而是“断言模式”：类不在 classmap 里就直接抛错，不再 fallback 到 PSR-4 拼路径——报错说明 classmap 漏了类，不是配置错了
怎么确认优化真的生效了
不能只看命令有没有报错，得验证两个硬指标：
- 打开
vendor/composer/autoload_real.php，搜索findFile：只保留if ($classMap = $this->classMap)分支，且完全删掉了foreach ($this->prefixesPsr4循环 - 用
strace -e trace=file php -r "new PDO();"观察系统调用：启用后应看不到大量stat("/path/to/vendor/xxx/yyy.php")失败记录 - 注意兼容性陷阱：
--classmap-authoritative是“全或无”，一旦漏掉运行时实际用到的类（比如空目录、动态生成类、autoload.files引入的辅助文件里 new 出来的类），就会立刻报错
