真正有效的命令只有一条：composer install --no-dev --optimize-autoloader --classmap-authoritative；dump-autoload -o 在 Composer 2+ 中仅为别名，不扫描新类、不重建 classmap，易致 Class not found。
生产环境 autoload 慢，90% 不是类太多，而是没走 classmap + 没开 OPcache 严格模式；真正有效的命令只有一条：composer install --no-dev --optimize-autoloader --classmap-authoritative，dump-autoload -o 在 Composer 2+ 中基本无效，且极易导致 Class not found。
为什么 dump-autoload -o 在生产环境不安全
dump-autoload -o 在 Composer 2.0+ 中只是 --classmap-authoritative 的别名，它不会重建 vendor/composer/autoload_classmap.php，也不扫描新类——只刷新轻量映射表。结果就是：文件不存在、内容为空、或仍含已删除类的路径。
- 执行后检查
vendor/composer/autoload_classmap.php：若文件大小为 0 或只有几十行，说明根本没生效 - 若项目没在
composer.json中显式配置"classmap": [...]，Composer 2.x 默认跳过 classmap 扫描，-o纯属空转 - CI/CD 中用它替代 install，本地能跑、线上报
Class not found是常态——因为 classmap 漏了类，而--classmap-authoritative直接禁用 fallback
install --optimize-autoloader 才是真动作
composer install 阶段才会真正扫描所有启用的 autoload 规则（PSR-4、classmap、files），并写入 autoload_classmap.php；--no-dev 是硬性前提，否则 autoload-dev 里的测试类会混进 classmap，白白膨胀数组、拖慢反序列化。
- 必须同时加
--no-dev：dev 依赖的类不会进 classmap，残留它们会让 autoloader 回退到慢路径 -
"optimize-autoloader": true写在composer.json里只是默认开关，不触发任何实际动作 - 验证是否生效：打开
vendor/composer/autoload_real.php，搜索addClassMap—— 若存在且被调用，说明 classmap 已加载；若只有setPsr4，优化就没进去
开了 --classmap-authoritative 却报 Class not found？先查这三处
--classmap-authoritative 不是“加速开关”，而是“断电式加载”：类不在 classmap 里就立刻失败，不尝试任何 fallback。报错不是配置错，是 classmap 漏了类。
-
composer.json中 PSR-4 命名空间末尾缺反斜杠，例如写成"App": "app/"而非"App\": "app/"→ 扫描器跳过整个目录 - 新增类文件但命名空间与目录结构不严格匹配，比如
app/Console/Commands/DeployCommand.php里写namespace AppConsoleCommands;（中间缺\）→ 不会被识别 - 用了
"files": ["app/Helpers/functions.php"]加载全局函数，这类文件不会进入 classmap；开了--classmap-authoritative后它们仍能加载（因 files 是独立逻辑），但容易误判为 autoload 整体失效
OPcache 和 APCu 配置不到位，优化全白做
即使 classmap 生成正确，若 OPcache 未启用或配置松散，每次请求仍要重新解析 autoload 文件，classmap 的优势完全无法释放。
-
opcache.enable=1和opcache.enable_cli=1必须同时开启——后者影响composer install生成的文件能否被缓存 -
opcache.revalidate_freq=0是生产刚需，否则每次请求都会检查autoload_classmap.php时间戳，白费 classmap 优化 - 部署后建议执行
apcu_clear_cache()：APCu 缓存的是 classmap 数组内容，不是文件句柄；文件被覆盖后，旧映射仍可能生效
最易被忽略的点：classmap 生成依赖于当前 composer.json 的 autoload 配置和代码文件状态，CI/CD 流水线中必须固化 composer install --no-dev --optimize-autoloader --classmap-authoritative，不能靠开发机上一次 dump-autoload 走天下——漏扫一个类，线上就炸锅。
