Jakarta MimeMessage超长List-Unsubscribe header折叠后被Gmail截断求助

问题描述 #

我需要为外发邮件添加List-Unsubscribe Header，使用Jakarta的MimeMessage。该Header的值可能超过1100字符，根据RFC5322第2.2.3节建议，每行长度不应超过76字符。

我尝试按RFC5322规则折叠超长Header值，使用MimeUtility.fold方法前，先在每76个字符后添加空格，代码如下：

String replacedString = sourceURL.replaceAll("(.{76})", "$0 "); 
return MimeUtility.fold(replacedString.length(), replacedString);

折叠后的输出看似正确，但发送至Gmail后，邮件源码中该Header值被截断，导致客户端无法显示退订选项。请问我的处理方式是否有问题？有没有更优方案？

注：List-Unsubscribe使用HTTP链接而非mailto链接，示例代码如下：

String listUnsubHeaderValue = "<https://www.ourcustomisedtrackingandredirectiondomain.com/20221014/track/unsubscribe?R=https%3A%2F%2Fourcustomisedtrackingandredirectiondomain.com%2F20221014%2Ftrack&T=b2NpZDEudGVuYW5jeS5vYzEuLmFhYWFhYWFhcGdxajVmamVrdTUycW9neXdwNGFnc2hkc2Nnb2c0Z2FldWs1dXhmY2N5eDVmb2ZwZzJvYQ==&F=dXNlckB0ZXN0ZG9tYWluNS5lbWFpbC5hcC1zeWRuZXktMS5vY2kub2MtdGVzdC5jb20=&D=c3JpbmlkaGkuay5tdXJ0aHlAZ21haWwuY29t&X=eyJ4LWdyb3VwLWlkIjoie1widHJpZ2dlcl9pZFwiOlwiOWZjNjRkMzctNjU2Ni00ZDhiLTliNGEtMDE4YmM3YzViNTliXCIsXCJjb21tdW5pY2F0aW9uX2lkXCI6XCIxMjM3MDE4ZC1jYWZkLTRiNGYtOTEwMy02NTYwN2QwODFjNjZcIixcInJlY2lwaWVudF9pZFwiOlwiODMzYTE2YzgtYjBlZC00ZTMzLWE5MzItNjI0ZGJjZGZiNzk3XCIsXCJwcm9kdWN0XCI6XCJIRVIzXCIsXCJyZWNpcGllbnRfdHlwZVwiOlwiU1RBTkRBUkRcIixcInBpcGVsaW5lX2tleVwiOlwiYTI1YmU4M2EtNzZlZS00NTg1LTlkMjctZTBlOTc4NjE3NTc2XCJ9IiwieC1jYW1wYWlnbi1pZCI6ImxvY2FsIiwieC1ub3RpZmljYXRpb24taWQiOiJIT01FX0VORVJHWV9WMyIsIlgtUHJvZHVjdC1JRCI6IlVUSUwifQ==&I=PDk4OTQ0NzYwNy4wLjE2ODc5NjEyMjcxNjBAWzE5Mi4xNjguMC4xNTZdPg==&V=1&C=1687961239075&S=xrMoCiRNI5Y1Lcwow0Lh74Yk7EB2-4Rlg0qwzubjL-I%3D>"

emailMimeMessage.setHeader(
    MimeConstants.LIST_UNSUBSCRIBE_HEADER,
    getfoldedTrackingURL(listUnsubHeaderValue));

private String getfoldedTrackingURL(String sourceURL) {
    String replacedString = sourceURL.replaceAll("(.{76})", "$0 ");
    return MimeUtility.fold(replacedString.length(), replacedString);
}

上述代码设置Header后，查看emailMimeMessage输出流能看到正确折叠的Header，但发送到Gmail后值被截断，无法显示退订链接。

问题分析 #

你的手动插入空格操作是多余的，甚至会导致问题：

• MimeUtility.fold方法本身会自动按照RFC5322规则处理Header折叠，无需手动插入空格。
• 手动添加的空格会嵌入到URL字符串中，虽然折叠后视觉上正确，但Gmail的Header解析器可能将这些额外空格视为URL的一部分，或者因折叠后的行不符合严格格式要求而截断内容。
• 调用fold时传入replacedString.length()作为每行最大长度，完全违背了折叠的初衷——该参数应该是你期望的每行最大字符数（建议76），而非原字符串长度。

修正方案 #

直接使用MimeUtility.fold方法，传入正确的每行最大长度（76），无需手动修改原URL：

private String getfoldedTrackingURL(String sourceURL) {
    // 每行最大长度设为76，符合RFC5322建议
    return MimeUtility.fold(76, sourceURL);
}

额外注意事项 #

• 确保List-Unsubscribe的格式完全符合RFC2369：单个HTTP链接需用<>包裹，若有多个链接用逗号分隔（如<https://xxx>, <https://yyy>）。
• 若仍出现截断问题，可尝试改用MimeUtility.foldLines方法，它能更灵活地处理长文本折叠：

  private String getfoldedTrackingURL(String sourceURL) {
      ByteArrayOutputStream baos = new ByteArrayOutputStream();
      try {
          MimeUtility.foldLines(76, sourceURL, baos);
          return baos.toString();
      } catch (IOException e) {
          // 处理异常，返回原URL作为 fallback
          return sourceURL;
      }
  }
  

• 测试时可直接查看邮件发送后的SMTP传输日志，确认Header在传输过程中是否被中间服务器（如邮件网关）截断，若有需排查网关的Header长度限制。

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