Symfony Mailer需Symfony 5.4+，低于此版本须先升级；国内用户应检查镜像同步情况；DSN配置须含协议、端口、加密类型；收件人必须用Address或Email对象包装；附件需显式指定内容、文件名及MIME类型。
Composer 安装 symfony/mailer 时提示 “package not found”
不是包名写错了，就是 Composer 镜像或版本锁死了旧生态。Symfony Mailer 自 5.4 起才正式替代 SwiftMailer，老项目若还锁着 "symfony/symfony": "4.4.*"，直接 composer require symfony/mailer 会失败——它不兼容 Symfony 4.x 的核心组件约束。
实操建议：
- 先运行
composer show symfony/symfony确认主框架版本；低于 5.4 就得先升级 Symfony（尤其symfony/mime和symfony/http-client是 mailer 的硬依赖） - 国内用户如果用阿里云镜像，要确认是否同步了 Packagist 新包：临时切回官方源试下
composer config -g repo.packagist composer https://packagist.org - 别装
symfony/swiftmailer-bundle——它和 mailer 冲突，已废弃
Mailer 里 transport 配置错导致 Symfony\Component\Mailer\Exception\TransportException
错误常出现在 .env 里写 SMTP 地址时漏了协议、端口或认证方式。比如写成 MAILER_DSN=smtp://user:pass@smtp.qq.com，缺端口和加密类型，实际必须是 smtp://user:pass@smtp.qq.com:587?encryption=tls。
常见陷阱：
-
gmail.com必须用smtp.gmail.com:587+encryption=tls，不能用ssl；启用两步验证后还得生成“应用专用密码”填进 DSN - 本地开发用
sendmail或logtransport 更安全：MAILER_DSN=sendmail://default或log://，避免误发测试邮件 - DSN 中的
user和pass如果含特殊字符（如@、/），必须 URL 编码，否则解析失败
用 MailerInterface 发邮件时收件人没生效
不是代码没写对，而是 Message 构建顺序错了。Mailer 不接受裸字符串收件人，必须用 new Address('to@example.com') 或 new Email('to@example.com') 包一层。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型写法对比：
use Symfony\Component\Mime\Email;
use Symfony\Component\Mailer\MailerInterface;
$email = (new Email())
->to(new \Symfony\Component\Mime\Address('to@example.com')) // ✅ 必须包装
->from('from@example.com')
->subject('Hi')
->text('Hello');
$mailer->send($email);
容易踩的坑：
-
->to('to@example.com')看似能过 PHP 类型检查，但运行时会被静默忽略——Mailer 只认Address或Email实例 - 批量发送时别反复 new Email()，复用一个实例调
->to()多次即可，内部是追加模式 - 如果用了
symfony/notifier，注意它默认走自己的chatter/texter，不是MailerInterface，别混用
SwiftMailer 迁移到 Mailer 后附件丢失或乱码
核心区别在 MIME 构建逻辑：SwiftMailer 允许直接传路径字符串给 attach()，而 Mailer 要求显式指定原始内容 + 文件名 + MIME 类型。
迁移要点：
- 旧写法
$message->attach('/path/to/file.pdf')→ 新写法必须用$email->attach(fopen('/path/to/file.pdf', 'r'), 'file.pdf', 'application/pdf') - 中文文件名需额外处理：
mb_convert_encoding('简历.pdf', 'ISO-8859-1', 'UTF-8')或改用 base64 编码内容再设Content-Transfer-Encoding: base64 - 内存大文件别用
fopen()直接读，先用file_get_contents()加判断，超 2MB 建议走流式传输（需自定义StreamableBody）
最易被忽略的是：Mailer 默认不自动探测附件 MIME 类型，application/octet-stream 是兜底值，浏览器可能拒打开——务必手动指定，比如 image/jpeg、text/csv。
