SpringBoot 2.7.15迁移至3.2.1：MimeMessage类型转换错误

问题原因 #

SpringBoot 3.x 基于 Jakarta EE 构建，彻底替换了旧的 Java EE（javax.*）API，邮件模块也从 javax.mail 迁移到 jakarta.mail。你遇到的错误是因为依赖中同时存在旧的 javax.mail 和新的 jakarta.mail 包，导致 JavaMailSender.createMimeMessage() 返回的是旧的 javax.mail.internet.MimeMessage，而代码中声明的是新的 jakarta.mail.internet.MimeMessage，类型不匹配。

解决步骤 #

1. 清理依赖，移除所有javax.mail相关包 #

确保项目中没有直接或间接引入 javax.mail 的依赖：

• Maven：检查pom.xml，删除所有javax.mail的直接依赖，同时排除其他依赖中引入的javax.mail：

<!-- 保留SpringBoot官方邮件 starter，它已依赖jakarta.mail -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

<!-- 示例：排除其他依赖中的javax.mail -->
<dependency>
    <groupId>你的其他依赖groupId</groupId>
    <artifactId>你的其他依赖artifactId</artifactId>
    <exclusions>
        <exclusion>
            <groupId>javax.mail</groupId>
            <artifactId>mail</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle：在build.gradle中排除javax.mail依赖：

implementation 'org.springframework.boot:spring-boot-starter-mail'
implementation '你的其他依赖groupId:你的其他依赖artifactId' {
    exclude group: 'javax.mail', module: 'mail'
}

2. 确保代码导入正确的jakarta包 #

你的代码已经导入了jakarta.mail相关类，这部分是对的，但需要确认没有残留的javax.mail导入：

// 正确导入
import jakarta.mail.MessagingException;
import jakarta.mail.internet.MimeMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;

3. 验证依赖一致性 #

执行依赖分析命令确认没有javax.mail包残留：

• Maven：mvn dependency:tree | grep javax.mail
• Gradle：./gradlew dependencies | grep javax.mail
  如果输出结果为空，说明清理成功。

额外修复：Logger导入问题 #

你的代码中LoggerFactory没有导入，需要补充：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

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