使用mailparser的simpleParser解析邮件时丢失附件自定义headers如何解决

问题定位 #

该现象不属于mailparser的bug，是simpleParser的默认设计逻辑：默认仅将附件的标准MIME头部（如Content-Type、Content-Disposition、Content-Transfer-Encoding等）处理为附件对象的直接属性，自定义头部不会默认填充到顶层headers字段中。你在Nodemailer端的两种headers配置方式都是正确的，问题出在解析端的配置。

解决方法 #

方案1：从原始头部行提取 #

simpleParser返回的每个附件对象都自带headerLines属性，存储了该附件所有原始头部的键值对，直接遍历提取即可：

const parsedMail = await simpleParser(rawEmailSource);
// 遍历所有附件
parsedMail.attachments.forEach(attachment => {
  // 匹配uid头部，key统一转小写避免大小写兼容问题
  const uidItem = attachment.headerLines.find(item => item.key.toLowerCase() === 'uid');
  const uid = uidItem ? uidItem.value : '';
  // 后续处理uid逻辑
})

方案2：配置解析器保留所有头部 #

如果你使用的是v3.0及以上版本的mailparser，可以在调用simpleParser时传入配置项，让解析器自动聚合所有头部到headers对象中：

const { simpleParser } = require('mailparser');

// 解析时添加配置，开启附件全头部保留
const parsedMail = await simpleParser(rawEmailSource, {
  keepAttachmentHeaders: true
});

// 直接通过headers的get方法获取自定义头
const uid = parsedMail.attachments[0].headers.get('uid');

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