Monolog Console处理器失效：配置疑问及运行异常求助

一、官方配置中!console频道排除的原因与作用逻辑 #

官方给出的开发环境配置如下：

# config/packages/dev/monolog.yaml
monolog:
    handlers:
        # ...
        console:
            type:   console
            process_psr_3_messages: false
            channels: ['!event', '!doctrine', '!console']

1. !console的作用逻辑 #

Monolog里频道配置的!前缀代表排除指定频道，这里的!console表示该控制台处理器不会处理console频道产生的日志。

2. 排除console频道的原因 #

Symfony控制台命令本身会自动生成console频道的系统级日志（比如命令启动、执行完成、异常退出等事件），这些日志由Symfony底层直接处理输出。如果不排除console频道，控制台处理器会重复输出这些系统日志，导致终端打印内容冗余。

3. 该处理器的存在意义 #

它的核心作用是输出应用业务代码产生的非系统级日志。比如你在控制台命令中，用默认app频道日志器打印的业务日志，会通过这个处理器输出到终端，同时避开系统自带的console频道日志，避免重复打印。

二、自定义配置无日志输出的问题排查与解决 #

1. 你的配置与代码 #

配置文件：

monolog:
  channels:
    - console
  handlers:
    console:
      type: console
      level: debug
      channels: ~

命令代码：

$this->logger->info('Starting command');

2. 控制台处理器工作原理 #

• 仅在CLI（命令行）运行环境下激活，Web环境下不会工作；
• 根据channels配置筛选日志：channels: ~表示接收所有频道的日志；
• 对符合条件的日志做终端友好格式化（比如用颜色区分级别）后输出。

3. 无输出的原因 #

你创建了console频道，但命令中注入的$this->logger默认是app频道的日志器（Symfony默认日志服务对应app频道），你的日志实际属于app频道，同时可能存在以下问题：

• 如果是在生产环境（prod），默认Monolog控制台处理器可能未启用；
• 日志未被该处理器正确接收（虽配置channels: ~，但可能存在其他配置冲突）；
• 日志器注入错误，没有使用console频道的日志实例。

4. 解决方法 #

方法一：使用默认频道输出

修改控制台处理器的channels配置，明确包含app频道（默认日志器的频道）：

monolog:
  handlers:
    console:
      type: console
      level: debug
      channels: ['app']

命令中继续使用$this->logger->info('Starting command');即可正常输出。

方法二：使用自定义console频道输出

1. 在services.yaml中绑定console频道的日志器到命令：

# config/services.yaml
services:
    _defaults:
        bind:
            $consoleLogger: '@monolog.logger.console'

2. 在命令构造函数中注入该日志器：

use Psr\Log\LoggerInterface;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

class YourCommand extends Command
{
    private $consoleLogger;

    public function __construct(LoggerInterface $consoleLogger)
    {
        $this->consoleLogger = $consoleLogger;
        parent::__construct();
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $this->consoleLogger->info('Starting command');
        // 其他业务逻辑
        return Command::SUCCESS;
    }
}

3. 确保配置文件在对应环境下生效（比如开发环境放在config/packages/dev/monolog.yaml，生产环境需要单独启用控制台处理器）。

额外注意

生产环境下，需要在config/packages/prod/monolog.yaml中显式启用控制台处理器，因为默认生产环境会关闭控制台日志输出。

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