Java中通过SMTP发送含内嵌图片邮件时遇空指针异常求助

以下是几种高频触发NPE的场景及对应的解决方法：

1. MimeMessageHelper实例未正确初始化 #

如果MimeMessageHelper本身为null，后续任何调用都会直接抛NPE。通常是创建helper时传入的MimeMessage无效，或者未捕获创建时的异常导致初始化失败。

解决方法：
确保MimeMessage由有效JavaMailSender实例生成，并且在创建helper时处理MessagingException：

// 确保JavaMailSender已正确初始化/注入
JavaMailSender mailSender = ...;
MimeMessage message = mailSender.createMimeMessage();
MimeMessageHelper helper = null;

try {
    // 第二个参数true必须传，表示支持多部分邮件（内嵌图片依赖此配置）
    helper = new MimeMessageHelper(message, true);
    // 提前设置收件人、主题等基础信息
    helper.setTo("xxx@example.com");
    helper.setSubject("内嵌图片测试邮件");
} catch (MessagingException e) {
    // 异常必须处理，避免helper保持null状态
    e.printStackTrace();
    // 可在此处添加告警或终止流程逻辑
}

// 调用任何helper方法前加非空判断
if (helper != null) {
    // 后续执行addInline等操作
}

2. ByteArrayResource实例为null #

如果生成ByteArrayResource的过程中出错（比如图片文件不存在、读取字节数组失败），会导致resource为null，若在addInline前的步骤中用到该对象，就会触发NPE。

解决方法：
检查图片字节数组的生成逻辑，确保字节数组有效：

// 读取本地图片示例
File imageFile = new File("/path/to/your/image.png");
if (!imageFile.exists()) {
    throw new IllegalArgumentException("图片文件不存在");
}

byte[] imageBytes = Files.readAllBytes(imageFile.toPath());
// 确保字节数组非空再创建资源对象
ByteArrayResource resource = new ByteArrayResource(imageBytes);

如果是从网络或输入流获取图片，需额外处理IO异常，避免字节数组为null。

3. JavaMailSender实例为null #

若使用Spring框架，JavaMailSender通常通过依赖注入获取，若配置错误（比如SMTP参数未正确配置、Bean未定义），会导致mailSender为null，调用createMimeMessage()时直接抛NPE。

解决方法：
检查Spring中JavaMailSender的Bean配置是否正确：

@Bean
public JavaMailSender javaMailSender() {
    JavaMailSenderImpl sender = new JavaMailSenderImpl();
    sender.setHost("smtp.example.com");
    sender.setPort(587);
    sender.setUsername("your-email@example.com");
    sender.setPassword("your-email-password");

    Properties props = sender.getJavaMailProperties();
    props.put("mail.smtp.auth", "true");
    props.put("mail.smtp.starttls.enable", "true");
    // 按需添加其他配置，比如超时参数
    props.put("mail.smtp.connectiontimeout", "5000");

    return sender;
}

手动创建实例时，确保所有SMTP参数都已正确赋值，避免实例化失败。

4. 邮件正文提前引用未初始化的Content ID #

如果先设置了包含Content ID的HTML正文，再初始化helper或resource，可能在设置正文时因关联对象未就绪触发NPE。

解决方法：
严格遵循执行顺序：初始化helper → 准备resource → 设置HTML正文 → 调用addInline绑定Content ID：

// 1. 初始化helper（已确保非空）
// 2. 准备图片资源
ByteArrayResource resource = ...;
// 3. 设置HTML正文，引用Content ID
String htmlContent = "<html><body>内嵌图片：<img src='cid:myImage'></body></html>";
helper.setText(htmlContent, true); // 第二个参数true表示启用HTML格式
// 4. 绑定Content ID与资源
helper.addInline("myImage", resource);

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