本地Symfony使用Mailtrap测试SMTP DSN无邮件接收问题排查

• 验证SMTP DSN配置准确性
  确认环境变量中的MAILER_DSN完全匹配Mailtrap提供的参数：

  • 格式应为smtp://{inbox_username}:{inbox_password}@smtp.mailtrap.io:2525，其中用户名是Mailtrap收件箱的ID，密码是对应生成的Token，而非你的账号密码。
  • 用框架命令验证配置是否生效，比如Symfony下执行php bin/console debug:container mailer，查看实际加载的DSN与配置是否一致，若不一致需清除缓存（php bin/console cache:clear）。

• 检查邮件收发地址配置

  • 确认TemplatedEmail的发件人（from）未设置为被拦截的无效地址，Mailtrap虽宽松，但极端情况下可能拒收异常发件人。
  • 核实收件人（to）是否为Mailtrap测试收件箱的地址，避免误填生产环境邮箱。

• 查看Mailtrap后台与队列状态

  • 登录Mailtrap后台，检查「Logs」或「Inbox Activity」：若无任何记录，说明邮件未发送到Mailtrap服务器；若有拦截/退回标记，根据提示调整配置。
  • 若使用异步队列（如Symfony Messenger），需确认队列消费者已启动，执行php bin/console messenger:consume async处理待发送邮件，避免邮件积压在队列中。

• 本地调试与日志排查

  • 取消代码中dump($email)的注释，打印邮件完整信息（发件人、收件人、上下文、传输配置），确认参数无误。
  • 开启邮件调试模式，比如在DSN后追加?debug=true，或查看框架日志文件（如Symfony的var/log/dev.log），捕捉未触发500错误的隐性发送异常。

• 排查网络限制

  • 用telnet smtp.mailtrap.io 2525测试端口连通性，若无法连接，说明本地/服务器防火墙、安全组阻止了2525端口，需开放端口或改用Mailtrap的465/587端口。
  • 部分主机商默认禁用SMTP端口，需联系服务商确认并开启。

• 补充传输配置细节

  • 在DSN中添加加密参数：smtp://user:pass@smtp.mailtrap.io:2525?encryption=tls，确保传输加密符合Mailtrap要求。

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