composer dump-autoload -o 不等于自动提速，它仅触发 classmap 生成，真正提速需配合 --classmap-authoritative，且必须确保 classmap 完整覆盖所有类，否则报错；生产环境应使用 composer install --no-dev --optimize-autoloader。
composer dump-autoload -o 不等于自动提速
它只是触发 classmap 生成的开关，但是否真能提速，取决于 PHP 版本、Composer 版本、项目结构和是否启用 --classmap-authoritative。在 Composer 2.x + PHP 7.4+ 环境下，composer dump-autoload -o 单独执行几乎不生效：它默认只刷新 autoload_static.php，不重建 autoload_classmap.php，更不会禁用 fallback 查找。
常见错误现象：
-
vendor/composer/autoload_classmap.php文件体积很小（几 KB）或根本不存在 - 运行
strace -e trace=stat php -r "new AppHttpControllersHomeController();"仍看到大量stat()调用 - 内存占用反而上升，
memory_get_peak_usage()显示 autoload 阶段翻倍
真正起效必须加 --classmap-authoritative
--classmap-authoritative 才是关闭运行时路径拼接和 file_exists() 检查的关键。它让 ClassLoader::findFile() 在 classmap 中查不到类时直接抛 Class not found，跳过所有 PSR-4 fallback 逻辑。
但这个参数不是“加速按钮”，而是“严格模式开关”——它要求 classmap 必须完整覆盖所有可加载类。否则报错不是配置错了，是 classmap 漏了类。实操要点：
- 必须和
--optimize（即-o）一起用：composer dump-autoload --optimize --classmap-authoritative - 确保
composer.json中"autoload": {"psr-4": {"App\": "app/"}}的命名空间以反斜杠结尾，否则扫描器跳过整个目录 - 检查
vendor/composer/autoload_classmap.php，搜索关键类名（如AppHttpControllersHomeController），确认有对应路径 - 开发环境禁用：
php artisan tinker、测试类、动态 require 的类都会失效
生产部署该用 install --optimize-autoloader，不是 dump-autoload -o
composer dump-autoload -o 是补救命令，适合本地调试；生产环境 CI/CD 流水线中必须固化的是：composer install --no-dev --optimize-autoloader。
原因在于：
-
install会重新扫描所有autoload和autoload-dev配置项（含psr-4、classmap、files），生成真正完整的 classmap -
dump-autoload -o默认不扫描autoload-dev下的路径，除非显式加--dev；而生产部署必须排除测试类，否则 classmap 膨胀、内存白占 - 如果项目里新增了
app/Console/Commands/DeployCommand.php但命名空间写成namespace AppConsoleCommands;（缺），install -o会漏掉它，但错误更早暴露——比运行时报Class not found更容易定位
classmap-authoritative 开了就报错？先看这三点
报 Class not found 不是 bug，是权威模式在严格执行。最容易被忽略的三个漏扫原因：
-
composer.json中"autoload": {"psr-4": {"App": "app/"}}少了末尾反斜杠，导致整个app/目录未被扫描 - 用了
composer/installers或 WordPress/Drupal 插件机制，它们依赖运行时动态注册 autoload，开了 authoritative 就断联 -
autoload-dev里误配了"Tests\": "tests/"，CI 构建时没加--no-dev，上线后 classmap 带了一堆测试类，真实业务类反而被挤出或路径错乱
最硬核的验证方式：打开 vendor/composer/autoload_classmap.php，手动搜类名。如果没出现，再查命名空间、文件名、目录声明——别猜，直接看表里有没有。
