composer dump-autoload 默认不生成静态类映射，需加 --optimize-autoloader 和 --classmap-authoritative 才启用权威 classmap 模式，此时仅从 vendor/composer/autoload_classmap.php 查找类，缺失即报错，不回退。
composer dump-autoload 为什么没生成 static 类映射
默认情况下 composer dump-autoload 只生成“类名 → 文件路径”的动态映射（即通过 classmap 或 PSR-4 自动发现），不会生成真正意义上的“静态”（编译后不可变、无运行时解析）类加载表。所谓“static autoload”，其实是 Composer 提供的 --classmap-authoritative 模式 + --optimize-autoloader 组合效果：它把所有类路径提前扫进一个大数组，跳过文件系统遍历和命名空间推测。
怎么让 composer 生成权威类映射（classmap authoritative）
关键不是“生成静态文件”，而是启用两项优化并确保 classmap 覆盖完整。以下命令会重建 autoloader 并强制只从 classmap 查找类：
composer dump-autoload --optimize-autoloader --classmap-authoritative
执行后，vendor/autoload.php 会加载 vendor/composer/autoload_classmap.php 这个纯数组文件，不再尝试 PSR-4 fallback 或文件存在性检查。
-
--optimize-autoloader：触发 classmap 扫描（包括autoload.classmap配置项 + 所有 PSR-4/PSR-0 声明目录） -
--classmap-authoritative：告诉 autoloader “classmap 是唯一可信来源”，遇到未命中直接抛Class not found，不继续猜路径 - 如果项目里有
autoload.files，它们仍会被包含，但不参与 classmap 构建 - 扫描范围受
composer.json中"autoload": {"classmap": [...]}显式路径控制；漏配会导致类找不到
为什么加了 --classmap-authoritative 还报 Class not found
常见原因是 classmap 没扫到目标类——尤其在开发中新增了类但没重新 dump，或类放在了未声明的目录下。错误现象典型如：Fatal error: Uncaught Error: Class "AppFoo" not found，即使文件明明存在。
- 确认类文件路径是否在
autoload.classmap或 PSR-4 的"App\": "src/"等配置覆盖范围内 - 检查是否用了
exclude-from-classmap把含类的目录排除了 - 运行
composer dump-autoload -v看 verbose 输出，确认扫描到了对应文件 - 注意：
--classmap-authoritative对require或include的裸 PHP 文件无效，只管new/use的类名
静态映射对性能和部署的影响
启用后，每次类加载省掉 realpath()、file_exists() 和命名空间路径拼接，生产环境可提升 5–15% 的请求初始化速度（尤其小文件多、IO 慢的机器）。但代价也很实在：
- 开发期改类名或挪文件后，必须手动再跑
composer dump-autoload，否则立刻报错 - CI/CD 流水线里若跳过该步骤，上线就会崩——别指望自动 reload
- 无法支持“按需动态 require 第三方类文件”这类 hack 写法（比如某些插件系统）
- 生成的
autoload_classmap.php体积变大，但现代 PHP opcache 能很好缓存它
真正容易被忽略的是：这个模式不改变 autoloader 的“行为契约”，只是收紧了查找策略。一旦 classmap 缺失，它不会退回到宽松模式——错就是错，没商量余地。
