使用PHPMailer发送邮件时Gmail收件箱不显示主题行问题求助

核心问题排查及修复步骤 #

• 清理HTML开头无效隐藏内容
  你提供的邮件源码开头有一段设置了全透明、隐藏属性的span标签，内容为无关的DeFi代币相关文本，这段内容会被Gmail优先抓取作为邮件预览，且隐藏属性会导致预览显示为空，还可能干扰主题识别。直接删除这段全部代码即可。如果需要自定义预览文本，需放在<body>最开头，使用样式display:none; font-size:0; line-height:0; max-height:0; max-width:0; opacity:0; overflow:hidden;，且内容要和邮件主题匹配，不要放置无关内容。
• 补全邮件head结构
  当前邮件的<head>中<title>标签为空，Gmail会读取该标签内容作为主题的补充参考，空值会干扰主题识别。修复方法是在<title>标签中填入和邮件主题完全一致的内容，不要留空。
• 补充纯文本备选内容
  你当前仅设置了HTML格式的邮件Body，没有配置纯文本版本的AltBody，Gmail解析HTML内容异常时会 fallback 到纯文本内容生成预览，缺失该配置会导致预览为空。在$mail->Body = $htmlContent;后补充以下代码即可：

// 直接提取HTML纯文本内容作为备选
$mail->AltBody = strip_tags($htmlContent);

如果追求更规范的显示效果，可以针对不同邮件模板手动生成对应纯文本内容赋值。

• 排查主题传参及编码问题
  先做测试验证：将$mail->Subject = $subject;替换为固定测试值$mail->Subject = '测试邮件主题';，发送后查看主题是否正常显示，排除$subject变量传参为空的问题。如果是编码导致的主题乱码/隐藏，可以给主题加上UTF-8编码声明：

$mail->Subject = '=?UTF-8?B?'.base64_encode($subject).'?=';

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