Grails中同名包依赖冲突：如何指定运行时加载的javax.mail类？

问题说明 #

项目中存在多个包含javax.mail.internet.MimeMessage类的Jar包，版本不一致导致运行时加载了旧版本类，其中protected InternetHeaders headers;字段未正确填充，无法为邮件内容和主题设置字符集，最终导致HTML格式邮件无法正常发送。

涉及冲突的Jar包 #

• javax.mail-1.6.2.jar
• geronimo-javamail_1.4_spec-1.2.jar
• javax.mail-1.5.1.jar
• javax.mail-api-1.5.1.jar

解决方案 #

1. 依赖管理层面排除冗余包 #

在构建工具中明确指定使用高版本的javax.mail实现包，排除其他仅含API或旧版本的冲突依赖：

• Maven配置示例：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.geronimo.specs</groupId>
            <artifactId>geronimo-javamail_1.4_spec</artifactId>
        </exclusion>
        <exclusion>
            <groupId>javax.mail</groupId>
            <artifactId>javax.mail-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle配置示例：

implementation 'com.sun.mail:javax.mail:1.6.2' {
    exclude group: 'org.apache.geronimo.specs', module: 'geronimo-javamail_1.4_spec'
    exclude group: 'javax.mail', module: 'javax.mail-api'
}

注：优先选择带完整实现的javax.mail-1.6.2.jar，而非仅含接口定义的API包或规范包。

2. 调整类加载优先级 #

若无法通过依赖管理解决，可通过JVM参数指定高版本Jar包优先加载：

java -Xbootclasspath/p:/绝对路径/javax.mail-1.6.2.jar 你的主类全限定名

如果是应用服务器（如Tomcat）部署，可将高版本Jar包放置在服务器lib目录的优先加载位置，或通过context.xml配置类加载顺序。

3. 自定义类加载器加载指定版本类 #

编写自定义类加载器，显式加载javax.mail-1.6.2.jar中的类，规避系统类加载器加载旧版本：

public class CustomMailClassLoader extends URLClassLoader {
    public CustomMailClassLoader(URL[] urls, ClassLoader parent) {
        super(urls, parent);
    }

    @Override
    protected Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException {
        // 优先加载javax.mail包下的类
        if (name.startsWith("javax.mail.")) {
            try {
                return findClass(name);
            } catch (ClassNotFoundException e) {
                // 未找到则交给父类加载器处理
            }
        }
        return super.loadClass(name, resolve);
    }
}

使用时将javax.mail-1.6.2.jar的路径转为URL传入自定义类加载器，用其加载邮件处理相关类。

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