Docker部署Symfony项目失败：MakerBundle类未找到错误

问题根源 #

你碰到的问题本质是：非开发环境下Symfony居然加载了只该在开发阶段用的MakerBundle，常见原因有两个：

1. Docker容器里Composer把开发依赖也装了，没只装生产依赖
2. Symfony的环境变量配错了，容器实际跑的是开发环境，但你以为是生产环境

具体解决办法 #

1. 让Composer只装生产依赖 #

在Docker构建或者启动的时候，执行Composer安装命令时加上--no-dev参数，这样就不会装MakerBundle这类开发依赖了：

composer install --no-dev --optimize-autoloader --no-scripts

如果是用Docker Compose，直接在docker-compose.yml的服务命令里配置：

services:
  php:
    build: .
    command: bash -c "composer install --no-dev --optimize-autoloader && php bin/console cache:clear"

2. 确认Symfony环境变量为非开发环境 #

保证容器里的APP_ENV环境变量设为prod（或者 staging 这类非开发环境）：
在docker-compose.yml里添加环境变量配置：

services:
  php:
    environment:
      - APP_ENV=prod

另外检查.env或者.env.local文件，别在非开发环境里强制启用MakerBundle。

3. 确保MakerBundle仅在开发环境注册 #

打开config/bundles.php，确认MakerBundle的注册条件是只有dev环境才加载：

return [
    // 其他bundle...
    Symfony\Bundle\MakerBundle\MakerBundle::class => ['dev' => true],
];

要是这里写成['all' => true]或者没加环境限制，非开发环境就会加载它，直接触发错误。

4. 清理缓存并重新构建容器 #

如果之前已经装过开发依赖，得把容器里的vendor目录和缓存清干净，重新构建：

docker-compose down -v
docker-compose build --no-cache
docker-compose up -d

额外提醒 #

别直接删composer.json里的MakerBundle，开发的时候它生成代码挺方便的，只要控制好它的加载范围就行。生产环境别忘了把APP_DEBUG设为0，避免暴露调试信息。

内容的提问来源于stack exchange，提问作者Onur