Java17+SpringBoot3升级后带附件邮件发送ClassCastException问题

这个类型转换异常的核心原因是类路径中混入了Apache Geronimo的JavaMail处理类，这些类实现的是旧版javax.activation.DataContentHandler接口，而非Spring Boot 3要求的jakarta.activation.DataContentHandler，导致类型转换不兼容。结合你的场景，给出以下解决步骤：

1. 彻底清理Geronimo相关依赖残留 #

即使你已经在依赖中排除了geronimo-javamail_1.4_mail，仍有可能其他间接依赖引入了该包。执行以下命令排查依赖树：

mvn dependency:tree | grep geronimo

如果发现有其他依赖携带Geronimo相关包，在对应的<dependency>中添加排除规则，确保类路径中完全移除Geronimo的JavaMail组件。

2. 统一替换为Jakarta Mail API #

你的代码中仍在使用旧版javax.mail的类（比如javax.mail.Message.RecipientType.TO），新旧API混合使用会加剧类加载冲突。将所有javax.mail相关的导入替换为jakarta.mail：

// 替换前
import javax.mail.Message;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;

// 替换后
import jakarta.mail.Message;
import jakarta.mail.internet.InternetAddress;
import jakarta.mail.internet.MimeBodyPart;
import jakarta.mail.internet.MimeMessage;
import jakarta.mail.internet.MimeMultipart;

3. 验证依赖版本兼容性 #

确保Jakarta相关依赖版本匹配，jakarta.mail-api:2.1.1与angus-mail:2.0.1、jakarta.activation:2.0.1是兼容的。可以简化POM依赖，去掉不必要的排除（如果已确认无Geronimo残留）：

<dependency>
    <groupId>jakarta.mail</groupId>
    <artifactId>jakarta.mail-api</artifactId>
    <version>2.1.1</version>
</dependency>
<dependency>
    <groupId>org.eclipse.angus</groupId>
    <artifactId>angus-mail</artifactId>
    <version>2.0.1</version>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>com.sun.activation</groupId>
    <artifactId>jakarta.activation</artifactId>
    <version>2.0.1</version>
</dependency>

4. 检查邮件构建逻辑 #

确保MIME多部分消息的构建完全基于Jakarta API，包括附件部分：

// 确保使用Jakarta Activation的类
import jakarta.activation.DataHandler;
import jakarta.activation.DataSource;
import jakarta.activation.FileDataSource;

// 附件构建逻辑保持，但类需为Jakarta包下的实现
MimeBodyPart att = new MimeBodyPart();
DataSource fds = new FileDataSource(file);
att.setDataHandler(new DataHandler(fds));
att.setFileName(fds.getName());
msg.addBodyPart(att);

完成以上步骤后，重新构建项目并测试带附件的邮件发送，即可解决类型转换异常问题。

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