--classmap-authoritative 不自动提速，因其生效需同时满足三个条件：必须配合 --optimize（-o）、显式传入 --no-dev，且 vendor/composer/autoload_real.php 的 findfile() 中不可含 psr-4 fallback 分支；否则仍会反复 stat 目录。
为什么 --classmap-authoritative 不等于“自动变快”
加了 --classmap-authoritative 但类加载还是慢，大概率是 autoloader 没真正丢弃 PSR-4 fallback 逻辑。它只在满足三个条件时才生效：--optimize-autoloader（或 -o）必须同时出现；--no-dev 必须显式传入；且最终生成的 vendor/composer/autoload_real.php 中 findFile() 方法里不能出现 $this->prefixesPsr4 或 $this->fallbackDirsPsr4 相关分支。否则，哪怕 autoload_classmap.php 文件存在，运行时仍会反复 stat() 目录。
如何验证 classmap 是否覆盖全部生产类
权威模式下，漏一个类就 Fatal error: Class 'Xyz' not found，不是配置错，是扫描没扫到。排查要点：
- 检查
composer.json的"autoload"块是否显式包含所有生产代码路径，比如"src/"、"app/"，而"tests/"、"examples/"默认不进生产 classmap - 运行
composer dump-autoload --optimize --classmap-authoritative --no-dev -v，观察输出中是否列出你关键类的完整路径（如App\Console\Commands\DeployCommand => src/Console/Commands/DeployCommand.php） - 直接打开
vendor/composer/autoload_classmap.php，用文本搜索确认类名是否存在——注意大小写和命名空间斜杠（App\Services\UserService≠App\Services\userservice） - 如果类来自第三方包，用
composer show -p vendor/package确认当前加载的是不是你认为的那个版本，不同版本的 classmap 内容可能完全不同
哪些代码会悄悄破坏权威性
即使命令跑对了，这几类代码也会让 autoloader 回退到普通模式：
- 运行时调用
ClassLoader::addPsr4()或addClassMap()—— 比如某些 Laravel 服务提供者或调试工具会在启动时 patch 加载器 - 使用
"files"类型自动加载（如"files": ["src/helpers.php"]），这类文件不会被写入 classmap，虽然会被require_once，但若 helpers.php 里又require了未声明的类，就会触发 fallback - 代码中存在
eval()、__autoload替代方案，或框架级的“运行时注册类”机制（如 Twig 扩展、Doctrine DQL 函数），它们无法被静态扫描捕获 -
composer.json里残留无用的"autoload": {"files": []}，每个文件都会被强制加载，且无法被 classmap 优化
部署脚本里最容易漏掉的关键点
CI/CD 流水线中，90% 的线上 Class not found 都源于这几点：
- 没在
composer.json的"config"块里写"classmap-authoritative": true—— 某些 Composer 2.2+ 版本仅靠命令行参数可能被忽略 - 用
composer dump-autoload -o替代composer install --no-dev --optimize-autoloader --classmap-authoritative—— 后者才确保 lock 文件、依赖版本、classmap 三者完全一致 - 执行命令前没
git checkout $TAG，导致本地代码与composer.lock不匹配，classmap 扫描的文件路径和线上实际部署的不一致 - 忘了加
--no-interaction -n，某些插件（如 laravel-mix）会在安装时卡住等待交互，导致构建失败或部分步骤跳过
classmap-authoritative 的精简本质不是删代码，而是把“不确定的查找”变成“确定的查表”。一旦路径和类名对不上，或者有任意一环绕过了静态扫描，它就立刻失效——这点比性能数字更值得盯紧。
