ThinkPHP 6 中 PHPMailer 发附件需用绝对路径、每次新建实例、中文名须 MIME 编码、大附件要调优内存与超时；四者缺一将导致静默失败或附件异常。
ThinkPHP 6 中用 PHPMailer 发附件，addAttachment 路径必须是绝对路径
相对路径（比如 ./uploads/file.pdf 或 public/uploads/file.pdf）在 CLI 环境或非 Web 根目录下执行时大概率失败，addAttachment 底层调用 file_exists 和 fopen，只认真实文件系统路径。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
app()->getRuntimePath()、root_path()或public_path()拼出绝对路径，例如：public_path('uploads/report.xlsx') - 发信前先检查文件是否存在：
if (!file_exists($absPath)) { throw new \Exception("附件不存在: {$absPath}"); } - 注意 Windows 下反斜杠问题，统一用
/或DIRECTORY_SEPARATOR，PHPMailer 内部对路径分隔符不敏感，但file_exists敏感
PHPMailer 实例化不能复用全局单例，每次发信都要新 new PHPMailer()
ThinkPHP 的 Mail::send() 封装层背后若缓存了 PHPMailer 实例，附件、收件人、主题等状态会残留，导致后续邮件莫名多出旧附件或发错人——这是最常被忽略的隐性 bug。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别把
PHPMailer实例存在容器或静态属性里；每次发信都new PHPMailer(true)（true开启异常模式） - 如果用了 ThinkPHP 的
think\facade\Mail，它本身不管理 PHPMailer 实例，但你封装的邮件服务类容易误写成单例 - 发完立刻 unset($mail)，避免内存中残留大附件资源（尤其 Base64 编码后体积翻倍）
中文附件名乱码？用 encodeHeader + mb_convert_encoding 处理
直接传入中文文件名如 $mail->addAttachment($path, '报表2024.xlsx')，Outlook 和部分安卓邮箱会显示为乱码或下载成 att00001.bin。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 附件名必须做 MIME 编码：
$mail->addAttachment($path, mb_encode_mimeheader('报表2024.xlsx', 'UTF-8', 'B')) - 确保 PHPMailer 版本 ≥ 6.5，低版本对
mb_encode_mimeheader兼容性差；若报错可降级用iconv('UTF-8', 'ISO-8859-1//IGNORE', $name)+base64_encode手动构造 - 别依赖
$mail->CharSet = 'utf-8'，它只影响邮件正文编码，不影响附件名
大附件（>5MB）触发超时或内存溢出，得关掉 isSMTP() 的 Debugoutput 并调大 memory_limit
PHPMailer 默认开启调试输出，大附件 Base64 编码过程会把整个文件内容 dump 到日志，极易撑爆内存或卡死进程；同时 SMTP 连接等待时间不够也会中断。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 发信前设：
$mail->SMTPDebug = 0;（不是false，是整数0） - 调大 PHP 内存限制：
ini_set('memory_limit', '256M');，并在addAttachment前用filesize($path)做大小拦截（比如 >10MB 提示用户上传网盘链接） - SMTP 超时设长一点：
$mail->Timeout = 60;，$mail->SMTPKeepAlive = true;可复用连接，但并发发多封时慎用
附件路径、实例生命周期、中文名编码、大文件处理——这四点漏掉任意一个，邮件就可能静默失败或附件打不开。尤其是路径和实例复用，线上查起来特别费时间。
