加了 --classmap-authoritative 后 Class not found 是因该参数彻底禁用 PSR-4/fallback 回退机制，仅依赖 classmap 查找：若类未被扫描进 autoload_classmap.php，则直接失败。
为什么加了 --classmap-authoritative 还是 Class not found
不是参数没生效，而是它直接切断了所有 fallback 逻辑：只要 vendor/composer/autoload_classmap.php 里没有这个类，new Foo() 或 class_exists('Foo') 就会立刻返回 false 或抛错，连 file_exists() 都不调一次。
常见漏扫原因包括：
-
"autoload"中 PSR-4 命名空间末尾缺反斜杠（如写成"App": "app/"而非"App\": "app/"），导致扫描器跳过整个目录 -
autoload-dev里的测试类被意外纳入（部署时没加--no-dev），而--classmap-authoritative又只认主 autoload，dev 类进不了 map 却又可能被运行时引用 - 用了
"files"类型加载（如全局 helper 函数），这类文件不会写入 classmap，但启用该参数后也不会触发额外 require —— 它们依然能用，但别指望被“权威”覆盖 - 某些包的类文件名与类名不严格匹配（比如
UserModel.php里定义class User），Composer 构建 classmap 时直接跳过
如何验证 --classmap-authoritative 真正生效了
光看命令执行成功没用。关键要确认两点：生成的 autoloader 是否删掉了 PSR-4 回退路径、classmap 是否真包含目标类。
实操检查步骤：
- 打开
vendor/autoload.php，搜索'classmap-authoritative' => true—— 必须存在 - 打开
vendor/composer/autoload_real.php，定位到findFile()方法：如果只剩if ($classMap = $this->classMap) { return $classMap[$class] ?? false; }这一段，且完全找不到$this->prefixesPsr4或$this->fallbackDirsPsr4相关代码，说明回退逻辑已被剥离 - 运行
php -r "var_dump(class_exists('AppModelsUser'));"，如果返回false且你确认该类在autoload_classmap.php里有对应条目，说明 classmap 已加载；如果返回false且条目不存在，则是扫描遗漏
生产环境必须配对使用的三个参数
单独加 --classmap-authoritative 很容易翻车。它真正发挥性能的前提，是 classmap 本身得完整、干净、可缓存。
部署时应固定使用这一组：
-
--no-dev：防止require-dev包的类混入 classmap，否则它们不仅占体积，还可能触发 fallback（因为 dev 类通常不在主 autoload 规则下） -
--optimize-autoloader（或-o）：把 PSR-4 映射也扁平化进 classmap，否则--classmap-authoritative会因找不到类而直接失败 -
--classmap-authoritative（或-a）：关闭所有动态查找，让每次类加载变成纯数组 key 查找
推荐命令：composer install --no-dev -o -a。Docker 构建阶段尤其适用 —— 一次生成，终身查表。
APCu 和 OPcache 不是可选项，而是 classmap 的加速器
有了 classmap 文件，只是第一步。每次请求仍要读取、反序列化 autoload_classmap.php，这部分开销在高并发下不可忽视。
两层缓存必须同时启用：
-
opcache.enable=1且opcache.validate_timestamps=0：让 OPcache 缓存整个 classmap 文件内容，避免重复磁盘 I/O -
"apcu-autoloader": true写进composer.json的config段，并确保apcu.enabled_cli=1（FPM 下生效）：APCu 缓存的是反序列化后的数组结构，查表速度比读文件快一个数量级
验证 APCu 是否命中：php -r "var_dump(apcu_fetch('composer:autoload'));" —— 有输出即表示缓存已生效。
真正容易被忽略的点是：classmap 文件本身不被缓存，它的内容也不进 OPcache，除非你显式开启 opcache.enable_file_override=1（不推荐）。所以 APCu 这一层，绕不开。
