Java邮件在Gmail中锚点链接失效：href与ID前缀不匹配问题

问题原因 #

Gmail为避免邮件内ID与页面其他元素ID冲突，会自动给邮件HTML中的所有id属性添加随机前缀（如m_-2166845457075511738），但处理逻辑存在格式不一致的bug：

• 目录链接的href被修改为#前缀_原锚点ID（前缀与原ID间带下划线）
• 目标锚点的id被修改为前缀原锚点ID（前缀与原ID间无下划线）
  两者格式不匹配，直接导致锚点跳转失效。

解决方案 #

1. 用name属性替代id定义锚点 #

Gmail不会对name属性做重写处理，这是最可靠的修复方案：

• 将目标章节的锚点从<a id="message_xxx"></a>修改为<a name="message_xxx"></a>
• 目录链接保持<a href="#message_xxx">不变

修改后的目标章节示例：

<table class="message" width="100%" align="center" cellpadding="0" cellspacing="0" border="0" style="border-bottom: solid #ccc 1px;">
      <tr>
            <td style="font-size: 13px; color: #333333; padding-left: 15px; padding-bottom: 15px; padding-top: 15px;">
                <a name="message_2401_6e8c478e-aabe-4789-ab22-8092e19c2dde"></a>
                <span ><strong>A display test</strong></span><br/>
                                                
                <p><a href="#pagetop">Top</a></p>
             </td>
          </tr>
</table>

2. 代码层面调整 #

只需在Thymeleaf模板中修改锚点的属性定义，确保generateDailyDigestFromTemplate方法输出的HTML使用name属性标记锚点即可，无需修改邮件发送的Java逻辑（发送代码本身无问题）。

验证方式 #

发送修改后的邮件后，在Gmail中查看邮件源代码，会发现name属性和对应href未被篡改，点击目录链接可正常跳转到目标章节。

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