启用 --classmap-authoritative 后需三步验证：执行 composer dump-autoload --classmap-authoritative --no-dev -o；检查 vendor/autoload.php 含 'classmap-authoritative' => true；确认 autoload_real.php 的 findfile 方法仅剩 $classmap 分支，无 psr-4 fallback 代码。
怎么确认 --classmap-authoritative 真生效了？
光跑命令不等于真启用。Composer 2.0+ 默认会保留 fallback 行为，除非你显式加 --classmap-authoritative，否则 vendor/composer/autoload_real.php 里仍保留 PSR-4 扫描逻辑。
验证步骤必须做三件事：
- 运行
composer dump-autoload --classmap-authoritative --no-dev -o（--no-dev不可省，否则 dev autoload 规则残留会触发 fallback） - 检查
vendor/autoload.php中是否含'classmap-authoritative' => true - 打开
vendor/composer/autoload_real.php，搜索findFile方法：如果只剩if ($classMap = $this->classMap)分支，且完全找不到$this->prefixesPsr4或$this->fallbackDirsPsr4相关代码，才算真正丢弃了动态查找
常见失效现象：线上跑了命令但 strace -e trace=stat,openat php -r "new App\Service();" 仍看到大量 stat("src/Service.php") 调用——说明 fallback 没关干净。
为什么加了 --classmap-authoritative 还报 Class not found？
不是参数没起作用，而是 classmap 漏掉了类。权威模式下，“不在 map 里 = 不存在”，没有容错余地。
典型漏类场景包括：
-
"files"类型加载的 helper 文件（如"src/helpers.php"）里又require了未声明命名空间的旧式类 - PSR-4 配置和实际目录结构错位（例如
"App\": "src/"，但App\Services\UserService实际放在src/Services/UserService.php，而src/下还有空子目录或占位文件，导致-o优化跳过扫描） - 第三方包用了非标准加载方式（如 Doctrine Proxy、Laravel Octane 的 runtime class generation），这些类不会被静态扫描进 map
-
.gitignore忽略了某些生产必需类（比如src/Commands/*Test.php被忽略，但部署后某处class_exists('App\Commands\FooTest')被调用）
解决办法不是关掉权威模式，而是先用 composer dump-autoload --classmap-authoritative --no-dev -o --verbose 看扫描日志，再检查 vendor/composer/autoload_classmap.php 是否真包含目标类名。
开发 vs 生产：什么时候该开，什么时候必须关？
开发中永远不要在本地 composer.json 里配 "classmap-authoritative": true，也不要日常执行带 --classmap-authoritative 的命令。
理由很实在：
- 每次新增一个
App\Controller\DemoController，就得手动跑一遍composer dump-autoload --classmap-authoritative --no-dev -o，否则立刻报错，打断编码节奏 - IDE 自动补全、测试运行器（如 PHPUnit）、甚至
php artisan tinker都依赖动态加载能力，关掉后体验断崖下跌 - 开发环境本就不该追求那点微秒级加载差异，而应优先保障迭代效率
只在 CI/CD 流水线最后一步、构建 Docker 镜像前、或 PHP-FPM 容器初始化时启用。部署脚本里写死这句：composer install --no-dev --optimize-autoloader --classmap-authoritative，确保每次上线都是“一次生成、全程信任”。
和 --optimize-autoloader 什么关系？能单独用吗？
不能单独用 --classmap-authoritative。它本身不生成 classmap，只是告诉 autoloader “请只信这张表”；而表从哪来？靠 --optimize-autoloader（即 -o）驱动扫描并填充。
关键区别：
-
--optimize-autoloader：生成autoload_psr4.php和初步autoload_classmap.php，但默认仍保留 fallback -
--classmap-authoritative：关闭 fallback，但若没-o，classmap 可能为空或极简（只含classmap配置项里明确列的路径）
所以生产命令必须是组合技：composer install --no-dev -o --classmap-authoritative。少一个参数，就等于白配。
容易被忽略的一点：Docker 构建时若复用旧 vendor/ 缓存，可能残留旧 classmap，导致新类没进表。建议在 Dockerfile 中加 RUN rm -rf vendor && composer install --no-dev -o --classmap-authoritative，不省这点时间。
