Spring Email从URL获取附件发送报错，如何解决？

原代码出现java.io.IOException: Exception writing Multipart的核心原因是直接操作MimeMessage与MimeMessageHelper混用，导致邮件多部分结构混乱，同时URL输入流的生命周期管理不当也可能引发读取异常。以下是修正后的实现方案：

关键问题分析 #

• 直接调用mimeMessage.setRecipient/setSubject/setText与MimeMessageHelper的操作冲突，破坏了Multipart消息的构建逻辑。
• URL输入流未妥善处理：直接传递原始流可能导致发送时流已关闭或无法重复读取。
• 未指定字符集：可能引发正文或附件名称的乱码问题。

修正后的完整代码 #

import org.springframework.core.io.ByteArrayResource;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.util.StreamUtils;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.logging.Logger;

@Async
public void sendWithAttachment(String to, String subject, String text, String attachmentUrl) {
    Logger log = Logger.getLogger(this.getClass().getName());
    try {
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
        // 初始化Helper，启用Multipart并指定UTF-8字符集
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true, StandardCharsets.UTF_8.name());
        
        // 统一通过Helper设置邮件核心内容
        helper.setTo(to);
        helper.setSubject(subject);
        helper.setText(text); // 若需发送HTML正文，使用helper.setText(text, true)

        // 处理URL附件：预读取内容到字节数组，避免流生命周期问题
        URL url = new URL(attachmentUrl);
        try (InputStream inputStream = url.openStream()) {
            byte[] attachmentContent = StreamUtils.copyToByteArray(inputStream);
            // 从URL解析附件文件名，替代固定名称
            String fileName = extractFileNameFromUrl(url);
            helper.addAttachment(fileName, new ByteArrayResource(attachmentContent));
        }

        // 若需保留全局配置的mimeMessagePreparator，需在Helper初始化前调用
        // mimeMessagePreparator.prepare(mimeMessage);

        javaMailSender.send(mimeMessage);
        log.info("邮件发送成功");
    } catch (MessagingException | IOException e) {
        log.severe("邮件发送失败：" + e.getMessage());
    }
}

// 辅助方法：从URL路径中提取文件名
private String extractFileNameFromUrl(URL url) {
    String path = url.getPath();
    int lastSlashIndex = path.lastIndexOf('/');
    return lastSlashIndex != -1 ? path.substring(lastSlashIndex + 1) : "attachment";
}

核心改进点 #

• 统一使用MimeMessageHelper：全程通过Helper构建邮件，避免直接操作MimeMessage导致的结构混乱，Helper会自动维护Multipart消息的正确格式。
• 预读取附件内容：使用Spring的StreamUtils将URL流转换为字节数组，再通过ByteArrayResource提供附件源，确保发送时内容可正常读取，同时避免流泄漏。
• 字符集指定：初始化Helper时明确UTF-8字符集，解决中文主题、正文或附件名的乱码问题。
• 动态文件名解析：从URL自动提取文件名，提升代码灵活性。

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