先说一个关键结论：在生产环境部署时，务必使用 `composer install` 命令，而不要使用 `dump-autoload`。 在 Composer 2.x 版本，特别是 2.9.6 及更高版本中，`composer dump-autoload -o` 基本不再生成 `vendor/composer/autoload_classmap.php` 文件。它仅会刷新 `autoload_static.php` 和 PSR-4 映射表，而真正的类映射表只有在执行 `install` 或 `update` 时才会被扫描并写入。 因此，在部署脚本中写入 `composer dump-autoload -o` 几乎等同于无效操作。更糟糕的是，它还可能加载一个几 MB 大小的空 classmap，从而拖慢应用程序的冷启动速度。 正确的做法是采用以下命令组合： ```bash composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction ``` * `--no-dev` 参数用于防止测试类混入主 classmap，否则 classmap 体积很容易膨胀到 2–5 MB。 * `--no-interaction` 参数则用于避免在 CI/CD 流程中因交互提示而卡住。 --- **`--classmap-authoritative` 仍然不生效？请先检查这三处** 这个参数并非一个“加速开关”，而更像是一种“断电式加载”机制：如果类不在 classmap 中，它会直接报 `Class not found` 错误，不再进行 fallback 查找。遇到 `Class not found` 报错时不必惊慌，这恰恰说明参数已经生效，只是 classmap 遗漏了某些类，而非参数本身未起作用。 问题通常出现在以下几个方面： 1. `composer.json` 中 PSR-4 命名空间末尾缺少反斜杠。例如写成 `"App": "app/"` 但格式不正确，导致扫描失败。 2. 新增类文件的命名空间与目录结构不严格一致。例如 `app/Console/Commands/DeployCommand.php` 中写的是 `namespace AppConsoleCommands;`，缺少反斜杠，Composer 自然无法识别。 3. 项目中动态调用了 `ClassLoader::addPsr4()` 或 `addClassMap()` 方法。一旦存在这种动态注册，权威模式就会退化，自动加载器会绕过 classmap 重新扫描。 --- **如何验证 classmap 确实已生成并生效？** 不能仅凭 `vendor/composer/autoload_classmap.php` 文件是否存在或大小来判断，关键是要确认它是否被加载并真正生效。 一个简单的测试方法： 1. 运行 `php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppHttpControllersHomeController'));"`。 2. 然后删除对应的类文件，再次执行。如果此时仍然返回 `true`，说明 fallback 机制仍在工作，`--classmap-authoritative` 并未生效。 3. 还可以检查 `vendor/composer/autoload_real.php` 文件，搜索 `addClassMap`——如果完全没有调用，说明 classmap 根本就没有被加载。 4. 更深入的方法，使用 `strace -e trace=stat,openat php -r "new AppHttpControllerHome();"` 进行观察，如果仍然存在大量 `stat()` 调用失败，说明自动加载器仍在进行 fallback 扫描。 --- **镜像源再快，也无法替代本地命令组合** 很多人认为更换阿里云、腾讯云等镜像源后，autoload 就能变快。实际上，镜像源仅加速包的下载，并不参与 classmap 的生成逻辑。更换镜像后 `install` 速度提升，并不代表 autoload 也随之变快。 类映射是否生成并生效，完全取决于本地 `composer.json` 的配置、执行的命令以及环境变量。设置 `COMPOSER_DEV_MODE=0` 或显式加上 `--no-dev` 参数，才会触发权威模式的启用（这是 Composer 2.2 版本之后的行为）。 此外，有一个容易踩的坑：如果项目使用了 `"files"` 来加载全局函数，`--classmap-authoritative` 会跳过这些文件的加载。因此，务必确认这些文件是否确实不需要在运行时被 require。 部署脚本中如果漏掉 `--no-dev`，或者没有配置 `--classmap-authoritative`，即使使用最快的镜像，autoload 的性能也几乎不会有任何提升。