Java Mailgun GUI项目：图片无法内嵌仅作为邮件附件发送问题求助

我是Java开发新手，正在做一个基于Mailgun的GUI邮件项目，遇到的核心问题：用户在JEditorPane中插入的图片，发送邮件时始终显示为附件，而非内嵌在正文里。

尝试1：Base64编码替换图片src #

我先用Base64编码替换图片的src属性，但问题没解决，代码如下：

private static void embedAndSendEmail(JEditorPane editorPane) throws IOException, BadLocationException, URISyntaxException {
    HTMLDocument doc = (HTMLDocument) editorPane.getDocument();
    ElementIterator iterator = new ElementIterator(doc);
    Element element;

    // Collect images to embed
    List<File> imageFiles = new ArrayList<>();
    while ((element = iterator.next()) != null) {
        AttributeSet attrs = element.getAttributes();
        Object nameAttr = attrs.getAttribute(StyleConstants.NameAttribute);

        if (nameAttr instanceof HTML.Tag) {
            HTML.Tag tag = (HTML.Tag) nameAttr;

            if (tag == HTML.Tag.IMG) {
                String src = (String) attrs.getAttribute(HTML.Attribute.SRC);
                if (src != null && src.startsWith("file:///")) {
                    // Read image data from editor pane
                    InputStream inputStream = new URL(src).openStream();
                    byte[] imageData = inputStream.readAllBytes();
                    String base64Image = Base64.getEncoder().encodeToString(imageData);

                    // Replace src attribute with base64 data
                    String newSrc = "data:image/png;base64," + base64Image;
                    doc.setInnerHTML(element, "<img src=\"" + newSrc + "\">");

                    // Add image file to the list (for sending email later)
                    String filePath = new URI(src).getPath(); // Convert URL to file path
                    imageFiles.add(new File(filePath));
                }
            }
        }
    }
}

尝试2：使用MimeBodyPart实现内嵌 #

后来改用MimeBodyPart的方式处理内嵌图片，结果图片还是被识别为附件，相关代码如下：

public class testing {
    private static void createAndShowGUI() {
        JFrame frame = new JFrame("Mailgun");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(1280, 720);
        
        //Listener to insert an image upon clicking
        imageInsert.addActionListener(e -> {
            JFileChooser fileChooser = new JFileChooser();
            fileChooser.setFileFilter(new FileNameExtensionFilter("Images", "jpg", "jpeg", "png", "gif"));
            if (fileChooser.showOpenDialog(frame) == JFileChooser.APPROVE_OPTION) {
                File imageFile = fileChooser.getSelectedFile();
                insertImage(editorPane, imageFile);
            }
        });
        
        JButton sendButton = new JButton("Send Email");
        sendButton.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                String to = emailField.getText();
                String subject = subjectField.getText();
                String content = "<html><body>"                
                        + editorPane.getText()
                        +"</body></html>";
                //Made to not allow an email to be sent till fields are not empty
                if (to.isEmpty() || subject.isEmpty() || content.isEmpty()) {
                    JOptionPane.showMessageDialog(frame, "Please fill in all fields.");
                    return;
                }

                try {
                    sendEmail(to, subject, content, imageFiles);
                } catch (IOException | MessagingException e1) {
                    e1.printStackTrace();
                }
            }
        });
    }

    private static void sendEmail(String to, String subject, String content, List<File> imageFiles) throws IOException, MessagingException {
        final String username = "";
        final   String password = "";
        Properties properties = new Properties();
        properties.put("mail.smtp.auth", "true");
        properties.put("mail.smtp.starttls.enable", "true");
        properties.put("mail.smtp.host", "smtp.mailgun.com");
        properties.put("mail.smtp.port", "587");

        Session session = Session.getInstance(properties, new javax.mail.Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(username, password);
            }
        });
        MimeMultipart multipart = new MimeMultipart("related");
        

        try {
            for (File imageFile : imageFiles) {
                MimeBodyPart imagePart = new MimeBodyPart();
                DataSource ds = new FileDataSource(imageFile);
                imagePart.setDataHandler(new DataHandler(ds));
                imagePart.setHeader("Content-ID", "<image>");
                imagePart.setDisposition(MimeBodyPart.INLINE);
                imagePart.setFileName(imageFile.getName());
                multipart.addBodyPart(imagePart);
            }
            

            MimeMessage message = new MimeMessage(session);
            message.setFrom(new InternetAddress(username));
            message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
            message.setSubject(subject);
            
            // Set the content of the message to the multipart
            message.setContent(multipart);

            // Send message
            Transport.send(message);
            JOptionPane.showMessageDialog(null, "Email sent successfully.");
        } catch (MessagingException e) {
            JOptionPane.showMessageDialog(null, "Failed to send email: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

问题排查与解决建议 #

• HTML正文未加入Multipart
  你当前的sendEmail方法只把图片添加到了multipart，但没有将HTML正文加入。邮件缺少正文部分时，图片会被默认识别为附件。需要创建单独的MimeBodyPart承载HTML内容，优先添加到multipart中：

  // 创建HTML正文部分
  MimeBodyPart htmlPart = new MimeBodyPart();
  htmlPart.setContent(content, "text/html; charset=utf-8");
  // 先添加正文到multipart
  multipart.addBodyPart(htmlPart);
  // 再循环添加图片部分
  

• Content-ID需唯一且与HTML关联
  所有图片使用同一个<image>作为Content-ID会导致冲突，且HTML中的<img>标签没有引用这个ID。给每个图片生成唯一ID（比如UUID），同时修改HTML中对应图片的src为cid:唯一ID：

  // 处理单个图片时
  String uniqueImageId = "img-" + UUID.randomUUID().toString();
  imagePart.setHeader("Content-ID", "<" + uniqueImageId + ">");
  // 同时在HTML中替换对应img的src为 "cid:" + uniqueImageId
  

• JEditorPane获取文本方式错误
  editorPane.getText()返回的是纯文本，会丢失HTML结构。应该通过HTMLEditorKit导出完整的HTML源码：

  HTMLDocument doc = (HTMLDocument) editorPane.getDocument();
  StringWriter writer = new StringWriter();
  HTMLEditorKit kit = new HTMLEditorKit();
  kit.write(writer, doc, 0, doc.getLength());
  String content = writer.toString();
  

• 手动指定图片MIME类型
  FileDataSource可能无法正确识别图片类型，建议手动设置：

  // 根据图片后缀判断类型，比如png/jpg
  imagePart.setHeader("Content-Type", "image/png");
  

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