Mailer组件不发邮件需依次排查：DSN格式（如Gmail须带auth_mode=login）、异步队列是否消费、模板路径是否为templates/开头且用context()传参、禁用已废弃的spool配置、确保fail_silently=false。
Mailer组件不发邮件？先确认MAILER_DSN格式对不对
Symfony默认用MAILER_DSN环境变量控制传输方式，写错一个字符就静默失败——不是报错，是根本没发出去。常见错误是把smtp://写成smtps://却没配TLS，或者Gmail账号用了App密码但DSN里没加?auth_mode=login。
实操建议：
-
MAILER_DSN=smtp://user:pass@smtp.gmail.com:587?encryption=tls&auth_mode=login（Gmail必须带auth_mode=login，否则465端口也不认） - 本地开发用
sendmail://default或smtp://localhost:1025配MailHog更可靠，避免被Gmail限流 - 检查
bin/console debug:config mailer输出，确认transports里真有你配的DSN，而不是fallback到null://
发邮件时MailerInterface::send()没反应？查异步和事件监听器
默认配置下send()是同步阻塞的，但如果你启用了framework.messenger.transport.async，邮件可能被扔进消息队列——而你没跑php bin/console messenger:consume，它就卡在数据库里不动。
实操建议：
- 开发阶段在
config/packages/mailer.yaml里强制禁用异步：transport: 'smtp'（别留null或async） - 监听
MessageEvents::MESSAGE_SENT时，别在事件处理器里抛异常，否则整个请求会500，且邮件已发出无法回滚 - 用
bin/console debug:event-dispatcher确认mailer.message_sent事件是否被意外拦截
模板邮件渲染失败？TemplatedEmail路径和参数要严格匹配
TemplatedEmail的htmlTemplate()和textTemplate()只接受templates/xxx.html.twig这种相对路径，不能写src/Resources/views/...或绝对路径，否则Twig loader直接报Unable to find template。
实操建议：
- 模板路径必须以
templates/开头，比如templates/email/welcome.html.twig，调用时传'email/welcome.html.twig' - 传给模板的变量必须用
context()，不是with()：->context(['user' => $user])，否则变量在模板里是null - 如果用了
inline_css: true，确保安装了symfony/css-selector和tijsverkoyen/css-to-inline-styles，否则静默降级为纯文本
生产环境邮件延迟或丢失？检查spool和fail_silently
Symfony 6.2+已移除spool机制，但老项目升级后若还留着spool: { type: 'memory' }配置，Mailer会直接忽略并 fallback 到null传输——发不出去还不报错。
实操建议：
- 删掉所有
spool相关配置，改用Messenger +SendEmailMessage做可靠投递 -
fail_silently: false必须设为false（默认值），否则SMTP认证失败、连接超时等全被吞掉，日志里只有Message not sent一行 - 在
config/packages/prod/mailer.yaml里显式指定transport: '%env(MAILER_DSN)%'，避免环境变量未加载导致用null://
真正麻烦的是SMTP连接池复用和DNS缓存——比如用AWS SES时，短连接频繁创建会触发限频，但开长连接又可能因DNS变更卡住。这些没法靠配置解决，得看传输层日志和网络层指标。
