使用GMAIL API发送邮件时触发java.lang.Class重复初始化失败异常

嘿，这个异常我之前碰到过好几次，大多和类加载冲突或者依赖版本不兼容有关，尤其是在异步任务这种类加载上下文和主线程不一样的环境里。结合你贴的代码，给你几个具体的排查和解决步骤：

1. 先搞定依赖兼容性问题 #

你现在用的是原生JavaMail的代码，但Gmail API本身已经封装了兼容的JavaMail版本。如果你的项目里同时引入了独立的JavaMail依赖，很容易出现类版本冲突，导致类初始化失败。

举个例子，如果你用Maven，先检查pom.xml：

• 确保只引入Gmail API的核心依赖，不要单独加旧版JavaMail：

<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-gmail</artifactId>
    <version>v1-rev20240508-2.0.0</version>
</dependency>
<dependency>
    <groupId>com.google.oauth-client</groupId>
    <artifactId>google-oauth-client-jetty</artifactId>
    <version>1.34.1</version>
</dependency>

Gmail API的依赖里已经包含了适配的JavaMail，重复引入只会添乱。

2. 调整异步任务的类加载器上下文 #

异步任务（不管是Spring的@Async还是自定义线程池）的类加载器经常和主线程不一样，有些类初始化失败后就没法重新加载了。你可以在异步方法里手动切换类加载器：

@Async
public void sendEmailAsync(String to, String from, String subject, String bodyText) throws Exception {
    // 先保存原来的类加载器，用完再恢复
    ClassLoader originalLoader = Thread.currentThread().getContextClassLoader();
    try {
        // 切换到当前类的类加载器，确保Gmail相关类能正确加载
        Thread.currentThread().setContextClassLoader(getClass().getClassLoader());
        
        // 这里执行你的邮件创建+发送逻辑
        MimeMessage email = createEmail(to, from, subject, bodyText);
        // 调用Gmail API发送的代码，比如：
        // gmail.users().messages().send("me", convertToGmailMessage(email)).execute();
    } finally {
        // 一定要恢复原来的类加载器，避免影响其他任务
        Thread.currentThread().setContextClassLoader(originalLoader);
    }
}

3. 改用Gmail API推荐的邮件创建方式 #

你现在的createEmail方法是原生JavaMail的写法，其实可以改成更适配Gmail API的版本，避免原生Session初始化的问题：

public Message createGmailCompatibleEmail(String to, String from, String subject, String bodyText) throws MessagingException, IOException {
    Properties props = new Properties();
    Session session = Session.getInstance(props, null);

    MimeMessage email = new MimeMessage(session);
    email.setFrom(new InternetAddress(from));
    email.addRecipient(javax.mail.Message.RecipientType.TO, new InternetAddress(to));
    email.setSubject(subject);
    email.setText(bodyText);

    // 转换成Gmail API需要的Message格式（Base64编码）
    ByteArrayOutputStream baos = new ByteArrayOutputStream();
    email.writeTo(baos);
    String encodedEmail = Base64.getUrlEncoder().encodeToString(baos.toByteArray());
    
    Message gmailMessage = new Message();
    gmailMessage.setRaw(encodedEmail);
    return gmailMessage;
}

这个方法直接返回Gmail API可以用的Message对象，减少中间环节的类加载问题。

4. 排查环境级别的类加载配置 #

如果是Android或者特定容器（比如Tomcat）环境，可能需要调整类加载参数：

• 确保所有依赖都被正确打包（比如用Maven Shade插件时，不要遗漏Gmail API的类）；
• 避免用太老的Java版本，Gmail API推荐Java 8及以上；
• 临时可以试试添加JVM参数-Xverify:none（不推荐长期用，仅用于排查是否是类验证问题）。

先从依赖检查和类加载器调整开始试，这两个是最常见的解决方法，应该能搞定你的问题。

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