Symfony日志通道的核心作用是分离管理不同来源和重要性的日志，关键在“声明—绑定—使用”闭环：先在monolog.yaml的channels中声明自定义通道，再为通道绑定专用处理器，最后通过服务容器、标签注入或别名获取对应LoggerInterface实例。
Symfony日志通道的核心作用是把不同来源、不同重要性的日志分开管理，避免混杂，方便排查和审计。配好通道不是加几行YAML就行，关键在“声明—绑定—使用”三步闭环。
声明自定义通道
在 config/packages/monolog.yaml 中显式列出你要用的通道名：
- 添加到
channels列表里，比如：channels: ['payment', 'api', 'security'] - 不声明的通道无法被容器识别，后续注入会失败
- 已有默认通道（如
app、doctrine、event）可直接使用，无需重复声明
为通道绑定专用处理器
每个通道需要至少一个处理器来决定日志写到哪、怎么写：
- 在
handlers下定义处理器，例如：payment_handler - 设置
type: stream或type: rotating_file，指定path: "%kernel.logs_dir%/payment.log" - 用
channels: [payment]严格限定该处理器只处理payment通道的日志 - 可同时为同一通道配置多个处理器（如文件 + Sentry），实现日志分发
在代码中获取并使用通道日志器
通道声明和绑定完成后，有三种常用方式拿到对应日志器：
-
服务容器直取：在控制器或服务中调用
$this->get('monolog.logger.payment') -
标签自动注入：在
config/services.yaml中给服务加标签{ name: monolog.logger, channel: payment }，再在构造函数中类型提示LoggerInterface $logger -
依赖注入别名：通过
monolog.logger.payment作为服务ID注入，需确保该服务已由 MonologBundle 自动注册
常见问题与验证要点
通道配置看似简单，但容易卡在细节上：
- 检查环境配置文件是否覆盖了主配置（如
config/packages/prod/monolog.yaml会完全替代默认配置） - 确认
channels声明和handlers.channels的值完全一致（大小写、引号、中括号都不能错） - 运行
bin/console debug:container --tag=monolog.logger查看所有可用通道日志器服务 - 测试时用
$logger->info('test')并立刻检查对应日志文件是否生成内容
