SpringBoot应用出现TraceInputStream缺失问题（附邮件依赖及服务代码）

看起来你在Spring Boot邮件服务中碰到了TraceInputStream缺失的问题，我来帮你分析下原因并给出解决方案：

问题根源 #

TraceInputStream是JavaMail（com.sun.mail包）中的内部类，你遇到这个问题大概率是依赖版本冲突导致的：Spring Boot的spring-boot-starter-mail已经内置了适配版本的JavaMail依赖，但你手动引入了javax.mail 1.5.3，这两个版本不兼容，导致类加载时找不到TraceInputStream。

解决方案 #

1. 移除手动添加的javax.mail依赖 #

Spring Boot的starter已经帮你管理了所有兼容的依赖版本，不需要手动引入javax.mail。修改你的pom.xml，只保留spring-boot-starter-mail即可：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
    <version>2.0.0.RELEASE</version>
</dependency>

删掉这段手动引入的依赖：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.5.3</version>
</dependency>

2. 排查依赖冲突（可选） #

如果移除后还是有问题，可以用Maven命令查看依赖树，确认是否有其他第三方依赖偷偷引入了旧版本的JavaMail：

mvn dependency:tree

找到冲突的依赖后，在对应的依赖节点下添加<exclusions>标签排除掉旧版本的JavaMail，比如：

<dependency>
    <!-- 某个第三方依赖 -->
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.sun.mail</groupId>
            <artifactId>javax.mail</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 避免直接依赖JavaMail内部类 #

如果你的代码中直接使用了TraceInputStream，建议尽量改用Spring Boot提供的JavaMailSender接口来实现邮件发送，避免依赖JavaMail的内部类（这类类在版本迭代中可能会被调整或移除）。比如你的EmailService可以这样写：

@Service
public class EmailService {
    @Autowired
    private JavaMailSender sender;

    public void send() throws MessagingException {
        // 简单文本邮件示例
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom("sender@example.com");
        message.setTo("recipient@example.com");
        message.setSubject("测试邮件");
        message.setText("这是来自Spring Boot的测试邮件内容");
        sender.send(message);

        // 如果需要发送带附件或HTML的邮件，使用MimeMessage
        // MimeMessage mimeMessage = sender.createMimeMessage();
        // MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
        // helper.setFrom("sender@example.com");
        // helper.setTo("recipient@example.com");
        // helper.setSubject("HTML邮件");
        // helper.setText("<h1>这是HTML内容</h1>", true);
        // sender.send(mimeMessage);
    }
}

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