composer dump-autoload --no-dev 仅跳过 autoload-dev 配置中的 PSR-4/classmap/files 映射(如 tests/),不触碰 autoload 主配置或已安装的 dev 包;若代码中仍引用 Tests 类,会直接报错,从而暴露生产环境隐患。

加 --no-dev 不等于跳过开发类加载,它只跳过 autoload-dev 配置里的路径映射 —— 如果你代码里直接 require 了 tests/ 下的文件,或者用了 files 类型的全局加载,--no-dev 完全不影响它们。
composer dump-autoload --no-dev 到底跳过了什么
它只忽略 composer.json 中 autoload-dev 块定义的自动加载规则,比如:
"psr-4": {"Tests\": "tests/"}"classmap": ["tests/"]"files": ["tests/bootstrap.php"]
但不会动 autoload 主块里的任何配置,也不会删 vendor/ 下已安装的 dev 包。只要 autoload 里写了 "App\": "src/",哪怕 src/ 里混着测试工具类,照样加载。
为什么生产环境 class not found,但本地正常
典型原因是:本地开发时没加 --no-dev,vendor/autoload.php 注册了 tests/ 映射;生产环境跑了 composer dump-autoload --no-dev,映射没了,但代码里还写着 use TestsTestCase; 或 new TestsFooTest()。
- 这不是 autoload 失败,是 PHP 解析阶段就报错:找不到类名
-
composer dump-autoload --no-dev能提前暴露这类问题 —— 它会让autoload-dev的映射彻底消失 - CI 流水线建议加这一步:
composer install --no-dev && composer dump-autoload --no-dev
什么时候必须手动跑 dump-autoload --no-dev
composer install --no-dev --optimize-autoloader 默认会触发一次 dump,所以多数部署场景下不用额外跑。但以下情况需要手动补上:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 你改过
composer.json的autoload或autoload-dev配置,又不想重装依赖 - 构建流程中动态生成了新类(比如从模板编译出服务类),且这些类在
autoload-dev路径下 - Docker 构建分层时,把代码 COPY 进去后才想刷新 autoload,而 vendor/ 是前置 COPY 的
命令就是:composer dump-autoload -o --no-dev。-o 启用 classmap 优化,--no-dev 确保不带进测试路径 —— 两个参数要一起用,单用 -o 仍可能加载 dev 类。
验证 --no-dev 是否真生效
别只信命令有没有报错,得看结果:
- 检查
vendor/composer/autoload_classmap.php文件大小,明显比开发环境小,说明 dev 类没进 map - 运行
php -r "require 'vendor/autoload.php'; var_dump(class_exists('TestsTestCase'));",应返回false - 确认
vendor/autoload.php最后几行是否还require了autoload_dev.php—— 如果有,说明--no-dev没起作用(常见于旧版 Composer 或缓存干扰)
最易被忽略的是:有些项目把 CI 脚本写成 composer install --no-dev && composer dump-autoload -o,漏了 --no-dev 参数,导致第二步又把 dev 映射加回去了。










