Composer自动加载变慢或类找不到的主因是autoload.psr-4配置错误：命名空间末尾必须为"App\": "app/"（JSON中双反斜杠表示单字面量反斜杠），少或多一个反斜杠、用正斜杠均导致PSR-4前缀匹配失败；同时需配合"autoload": {"classmap": ["app/"]}和composer dump-autoload -a生成完整classmap，生产部署必须用--no-dev --optimize-autoloader，并慎用--classmap-authoritative。
直接说结论：composer.json 里 autoload.psr-4 的写法错误、目录结构不匹配、或混入了未声明路径，是自动加载变慢甚至类找不到的最常见原因——不是类多，是映射没对上。
psr-4 命名空间末尾必须带反斜杠
写成 "App": "app/" 或 "App\": "app/"（双反斜杠是 PHP 字符串转义，实际值仍是单反斜杠）都错；正确只能是 "App\": "app/"（JSON 中写两个反斜杠，表示一个字面量反斜杠），且这个反斜杠不能少、不能多、不能用正斜杠代替。
原因很简单：Composer 用这个字符串做前缀匹配，AppHttpController 和 AppHttpController 是完全不同的命名空间。少一个反斜杠，它就会把 App 当作独立前缀去匹配，导致所有子命名空间（如 AppHttp）全失效。
- 检查方式：运行
php -r "var_dump(require 'vendor/composer/autoload_psr4.php');"，看输出里App对应的路径是否是你期望的app/ - Windows 下大小写不敏感容易掩盖问题，上线前务必在 Linux 环境执行
php -r "var_dump(class_exists('App\Http\Controller\HomeController'));"验证 - 如果用了 IDE 自动生成命名空间，注意它有时会漏掉末尾反斜杠，尤其从文件路径转换时
classmap 不是 dump-autoload -o 自动触发的
composer dump-autoload -o 在 Composer 2.x 下默认只优化 PSR-4 映射为静态数组（写入 autoload_static.php），并不会扫描目录生成 autoload_classmap.php——除非你已经在 composer.json 的 autoload.classmap 字段里明确列出了要扫描的路径。
也就是说，想让 App\ 下所有类走 classmap 查表，不能只靠 -o，得先手动加配置：
"autoload": {
"psr-4": {
"App\": "app/"
},
"classmap": ["app/"]
}
- 加了
"classmap": ["app/"]后，再跑composer dump-autoload -a（-a强制重扫 classmap），才会真正生成autoload_classmap.php -
-a比-o更彻底：它会递归读取指定目录下每个.php文件，提取class、interface、trait声明，不依赖命名空间与路径是否一致 - 别把
tests/或examples/加进classmap，它们会被无差别扫入，膨胀映射表且无意义
autoload-dev 里的路径会污染生产 autoload
开发时加在 autoload-dev.psr-4 里的测试类映射（比如 "Tests": "tests/"），默认也会被 composer dump-autoload 扫描并写入主 autoload 文件——除非你部署时显式排除。
这会导致两个问题：一是映射表体积增大，二是可能因测试类命名空间和生产类冲突引发意外 fallback。
- 生产环境部署必须用
composer install --no-dev --optimize-autoloader，而不是只跑dump-autoload -o -
--no-dev会跳过autoload-dev配置，避免测试路径进映射；--optimize-autoloader则确保 classmap 被重建（前提是autoload.classmap已配置） - 验证是否生效：部署后检查
vendor/composer/autoload_classmap.php里有没有Tests\开头的条目；有，说明--no-dev没起作用
--classmap-authoritative 容易报 Class not found 却不告诉你为什么
加了 --classmap-authoritative（或 -a）后，Composer 就不再 fallback 到 PSR-4 拼路径查找，类不在 autoload_classmap.php 里就直接抛错。但错误信息不会提示“你漏扫了 app/Console/Commands/”，只会冷冰冰地报 Class 'AppConsoleCommandsDeployCommand' not found。
这种静默失败最难排查，因为问题往往藏在细节里：
- 新增类文件后忘了重跑
composer dump-autoload -a - 类文件里 namespace 写成了
namespace AppConsoleCommands;（少了个反斜杠），而composer.json里是"App\": "app/"，导致 PSR-4 匹配失败，classmap 又没扫到（因为命名空间不标准） - 用了
"files": ["app/helpers.php"]加载全局函数，这类文件不会进 classmap，但开了 authoritative 后仍能加载——所以报错一定不是它，而是真漏类了
真正关键的不是加不加这个参数，而是你是否敢保证：所有类文件都在 autoload.classmap 列出的路径里，且命名空间和目录结构 100% 一致。否则，它带来的不是提速，是部署后第一笔请求就 500。
