Spring Boot邮件模板发送报错：LineInputStream接口不兼容求助

核心问题分析 #

这个错误是Javax Mail与Jakarta Mail的API/实现版本不兼容导致的。Spring Boot 3.x起全面切换到Jakarta EE规范（替代原Java EE），spring-boot-starter-mail在3.x版本中依赖的是Jakarta Mail相关包，但如果项目中手动引入了旧版com.sun.mail:javax.mail（Javax时代的实现），或者其他依赖间接带入了Javax Mail类，就会出现类不匹配：旧实现类对应的是Javax接口，而Spring Boot 3.x需要的是Jakarta接口。

具体解决步骤 #

1. 对齐Spring Boot版本与依赖体系 #

• 若用Spring Boot 3.x：只保留spring-boot-starter-mail，不要手动添加jakarta.mail:jakarta.mail-api或com.sun.mail:javax.mail，starter已经包含了正确的Jakarta Mail API和实现。
• 若用Spring Boot 2.x：则统一使用Javax Mail相关依赖，禁止混用Jakarta包。

2. 清理冲突依赖 #

在pom.xml（Maven）或build.gradle（Gradle）中操作：

• 移除所有手动添加的邮件相关依赖，让starter管理版本。
• 用依赖分析工具排查间接引入的冲突：
  • Maven：执行mvn dependency:tree，找到引入javax.mail的依赖，通过<exclusions>排除：

    <dependency>
        <!-- 存在冲突的依赖 -->
        <groupId>xxx</groupId>
        <artifactId>xxx</artifactId>
        <version>xxx</version>
        <exclusions>
            <exclusion>
                <groupId>javax.mail</groupId>
                <artifactId>mail</artifactId>
            </exclusion>
            <exclusion>
                <groupId>com.sun.mail</groupId>
                <artifactId>javax.mail</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    

  • Gradle：执行gradle dependencies，找到冲突后用exclude排除：

    dependencies {
        implementation('xxx:xxx:xxx') {
            exclude group: 'javax.mail', module: 'mail'
            exclude group: 'com.sun.mail', module: 'javax.mail'
        }
    }
    

3. 统一代码中的包路径 #

确保所有邮件相关代码使用Jakarta Mail的包（jakarta.mail.*），不要用旧的javax.mail.*：

• 正确示例：import jakarta.mail.internet.MimeMessage;
• 错误示例：import javax.mail.internet.MimeMessage;

4. 清理构建缓存 #

• Maven：执行mvn clean install，清除本地仓库中可能存在的混合版本依赖。
• Gradle：执行gradle clean build --refresh-dependencies，强制刷新依赖并清理缓存。

额外注意事项 #

• 若用Thymeleaf等模板引擎，确保版本与Spring Boot兼容（比如Spring Boot 3.x需Thymeleaf 3.1+），避免间接引入冲突依赖。
• 邮件配置（application.properties/application.yml）前缀仍为spring.mail.*，无需修改，只需保证配置属性符合Jakarta Mail要求。

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