spring-integration-mail Maven项目javax.mail传递依赖问题及示例需求

嘿，我之前也碰到过这个坑！大概率是Spring Boot版本升级后，javax.mail被替换为jakarta.mail导致的传递依赖冲突——毕竟Spring Boot 2.7+开始全面迁移到Jakarta EE规范，原来的javax.mail相关包已经被替换成jakarta.mail:jakarta.mail-api这类了。

下面给你一个配置完全正确的Spring Boot + spring-integration-mail的Maven项目pom示例，同时帮你规避依赖冲突：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <!-- 推荐用稳定的3.x版本，比如3.2.0，已经完全适配Jakarta EE -->
        <version>3.2.0</version>
        <relativePath/> <!-- 从仓库拉取父pom，不用本地路径 -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>mail-integration-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>mail-integration-demo</name>
    <description>Demo project for Spring Integration Mail</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <!-- Spring Integration核心启动器 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-integration</artifactId>
        </dependency>
        <!-- Spring Integration Mail模块，不用手动指定版本，父pom会统一管理 -->
        <dependency>
            <groupId>org.springframework.integration</groupId>
            <artifactId>spring-integration-mail</artifactId>
        </dependency>
        <!-- Spring Boot Mail启动器，自动引入兼容的Jakarta Mail依赖，完美适配Integration -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-mail</artifactId>
        </dependency>

        <!-- 测试依赖，按需添加 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.integration</groupId>
            <artifactId>spring-integration-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

几个关键要点： #

1. 依赖不用乱加：
   完全不需要手动引入javax.mail或jakarta.mail包！spring-boot-starter-mail已经通过Spring Boot父pom锁定了正确的邮件依赖版本，spring-integration-mail会自动依赖这个兼容版本，从根源避免冲突。
   如果你还在使用Spring Boot 2.x版本（还在用javax.mail），也不用手动指定spring-integration-mail的版本，父pom会帮你匹配对应的Spring Integration版本。

2. 排查冲突的小妙招：
   要是还是碰到依赖冲突，用Maven的依赖树命令找出问题根源：

   mvn dependency:tree -Dincludes=javax.mail,jakarta.mail
   

   找到冲突的包后，直接在对应的依赖里排除掉就行，比如：

   <dependency>
       <groupId>org.springframework.integration</groupId>
       <artifactId>spring-integration-mail</artifactId>
       <exclusions>
           <exclusion>
               <groupId>javax.mail</groupId>
               <artifactId>mail</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

3. 配套的配置文件示例：
   最后给你补个application.properties的基础配置，直接用就行：

   # 发送邮件的SMTP配置
   spring.mail.host=smtp.example.com
   spring.mail.port=587
   spring.mail.username=your-email@example.com
   spring.mail.password=your-app-password
   spring.mail.properties.mail.smtp.auth=true
   spring.mail.properties.mail.smtp.starttls.enable=true
   
   # 接收邮件的IMAP配置（Spring Integration用）
   spring.integration.mail.imap.host=imap.example.com
   spring.integration.mail.imap.port=993
   spring.integration.mail.imap.username=your-email@example.com
   spring.integration.mail.imap.password=your-app-password
   spring.integration.mail.imap.protocol=imaps
   

这样配置完，项目就能正常跑起来，不会再被javax.mail的依赖问题折腾了！

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