Gmail API未识别邮件附件，仅标记为multipart/mixed如何解决？

你发送的邮件虽使用multipart/mixed类型，但Gmail API未将附件标记为有效附件（hasAttachments: false），导致无法获取附件ID。核心原因是附件的MIME部分缺少Disposition头，Gmail需要这个头明确识别内容为附件而非内嵌资源。

修复步骤 #

在创建附件MimeBodyPart时，添加setDisposition方法，将内容标记为附件：

attachmentPart.setDisposition(MimeBodyPart.ATTACHMENT);

修改后的完整代码 #

private MimeMessage createMimeMessageWithAttachments(final MailObjectRequestPayload mail) throws MessagingException, IOException {

    final List<MultipartFile> attachments = mail.getAttachment();

    // 创建MimeMessage
    final Session session = Session.getDefaultInstance(new Properties());
    final MimeMessage mimeMessage = new MimeMessage(session);

    // 设置邮件主题、内容和收件人
    mimeMessage.setSubject(mail.getSubject());

    final Multipart multipart = new MimeMultipart();

    final MimeBodyPart htmlPart = new MimeBodyPart();
    htmlPart.setContent(mail.getBody(),"text/html");
    multipart.addBodyPart(htmlPart);

    for (MultipartFile attachment : attachments) {

        final MimeBodyPart attachmentPart = new MimeBodyPart();
        ByteArrayDataSource source = new ByteArrayDataSource(attachment.getBytes(), attachment.getContentType());
        attachmentPart.setDataHandler(new DataHandler(source));
        attachmentPart.setFileName(attachment.getOriginalFilename());
        // 关键：标记当前部分为附件
        attachmentPart.setDisposition(MimeBodyPart.ATTACHMENT);

        // 将附件添加到多部分内容中
        multipart.addBodyPart(attachmentPart);
    }

    mimeMessage.setContent(multipart);
    return mimeMessage;
}

额外验证点 #

• 确保attachment.getContentType()返回正确的MIME类型（如application/pdf、image/png），避免使用application/octet-stream这类通用类型（虽Gmail可识别，但明确类型更稳妥）。
• 确认附件文件名不为空或无效，Gmail可能忽略无文件名的附件。

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