JSP借助Gmail SMTP发送邮件出现NoSuchMethodError的问题咨询

java.lang.NoSuchMethodError 是典型的类加载冲突与版本不匹配问题：

• 本地运行普通Java应用时，全程使用本机JDK 1.8.0_251的原生SSL栈与对应版本邮件类库，方法调用路径完全匹配，因此代码可正常运行。
• Payara/GlassFish这类Web容器默认采用父类优先的类加载机制，会优先加载容器自身内置的公共类库。容器内置的旧版SSL实现没有包含Handshaker.setApplicationProtocols方法，当容器内置的高版本邮件类在SSL握手阶段尝试调用该方法时，就会直接抛出方法不存在的错误。

1. 调整类加载优先级 #

修改Web应用的类加载顺序，强制优先加载应用自身的类库，避免被容器内置类截胡：

• 在应用的WEB-INF目录下找到glassfish-web.xml配置文件，无该文件则新建
• 添加如下配置，关闭父类加载优先规则：

<glassfish-web-app>
    <class-loader delegate="false"/>
</glassfish-web-app>

配置生效后，类加载请求会优先从应用自身的WEB-INF/lib目录查找类，找不到再请求容器公共类库。

2. 替换为标准化的SMTP SSL连接配置 #

移除代码中老旧的手动指定SSLSocketFactory的写法，改用JavaMail原生支持的SSL配置，减少和旧SSL栈的兼容问题：
将原有Properties配置替换为：

props.put("mail.smtp.host", "smtp.gmail.com");
props.put("mail.smtp.port", "465");
props.put("mail.smtp.ssl.enable", "true");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.ssl.trust", "smtp.gmail.com");

注意：Gmail禁止直接使用普通账户密码做客户端授权登录，需在谷歌账号安全设置中开启两步验证，生成16位的应用专用密码替换代码中的普通密码，否则连接会被谷歌拒绝。

3. 清理并固定应用依赖版本 #

检查应用WEB-INF/lib目录下的类包：

• 放入和本地测试时版本完全一致的JavaMail包，不要依赖容器内置的邮件实现
• 删除所有版本低于1.6.2的旧版JavaMail依赖，避免类版本混乱
• 不要混用javax.mail和jakarta.mail的类包，保持和容器API版本一致
• 移除所有额外引入的第三方TLS补丁包，避免覆盖JDK原生SSL实现

4. 兜底兼容配置 #

如果上述修改后仍报错，说明容器内置的SSL栈过旧不支持ALPN协议，可在JSP代码最开头添加系统属性配置，绕开不存在的方法调用：

// 固定SSL握手协议为TLSv1.2，避免触发ALPN相关的方法调用
System.setProperty("jdk.tls.client.protocols", "TLSv1.2");

5. 优化异常捕获逻辑 #

当前代码的空catch块会隐藏具体错误信息，替换为可定位问题的逻辑：

} catch (MessagingException e) {
    e.printStackTrace();
    result = "发送失败，错误信息：" + e.getMessage();
}

内容的提问来源于stack exchange，提问作者Alondra Sánchez