启用Symfony生产环境清理缓存时出现profiler服务不存在错误求助

问题场景 #

启用Symfony生产环境，执行composer dump-env prod后清理缓存，出现以下错误：

In ContainerBuilder.php line 992:

You have requested a non-existent service "profiler".

Symfony版本6.3，PHP版本8.2。

解决方案 #

1. 确认生产环境profiler配置状态 #

生产环境默认禁用profiler服务，若代码中存在调用profiler的逻辑，就会触发该错误。检查config/packages/prod/framework.yaml配置：

framework:
    profiler: { enabled: false }

确保该配置未被修改为启用状态，除非你明确需要在生产环境使用profiler（不推荐，会影响性能）。若确实需要启用，可调整为：

framework:
    profiler:
        enabled: true
        collect: false # 默认不收集数据，需手动触发

2. 排查代码中的profiler调用 #

检查项目代码（控制器、服务、事件订阅者等），看是否存在硬编码调用profiler的逻辑：

• 避免直接使用$this->get('profiler')，改用依赖注入ProfilerInterface并添加环境判断
• 在调用前先判断服务是否存在：

// 控制器或服务中
if ($this->container->has('profiler')) {
    $profiler = $this->container->get('profiler');
    // 后续逻辑
}

• 若仅在开发/测试环境需要profiler，可通过配置限制服务注入的环境：

# config/services.yaml
services:
    App\Service\YourService:
        arguments:
            $profiler: '@?profiler' # 可选注入，不存在时传入null
        tags:
            - { name: kernel.event_subscriber, env: 'dev,test' } # 仅在指定环境加载

3. 使用正确的缓存清理命令 #

生产环境清理缓存需明确指定环境：

php bin/console cache:clear --env=prod

避免因环境变量覆盖导致加载了开发环境的配置（比如本地环境默认APP_ENV为dev，需确保执行命令时环境变量为prod）。

4. 验证环境变量配置 #

执行composer dump-env prod后，会生成.env.local.php文件，检查文件中APP_ENV是否为prod：

return array (
  'APP_ENV' => 'prod',
  // 其他环境变量
);

若存在冲突的环境变量（比如系统环境变量APP_ENV被设置为dev），会覆盖该配置，需手动调整。

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