Tomcat部署JAX-RS项目发送HTML邮件报500错误问题咨询

你当前代码存在多个会直接触发运行时异常、最终导致Tomcat返回500状态码的问题，按影响优先级排列：

• 缺少核心发信逻辑：你完成MimeMessage对象的属性配置后，没有调用Transport.send(msg)执行实际的邮件发送操作，不仅邮件无法发出，部分场景下未释放的会话资源还会触发容器侧的未捕获异常。
• SMTP认证信息为空：代码中username、password字段为空字符串，Gmail SMTP强制要求账号认证，空值会直接抛出认证失败异常；且你当前仅在控制台打印异常信息，没有向上层抛出或做业务兜底，异常直接抛到Tomcat容器就会返回500错误。
• 发件人地址无效：setFrom方法中填入的是掩码后的******@gmail.com，Gmail会校验发件人地址必须和认证账号完全一致，无效地址会直接触发MessagingException。
• 全局静态配置的并发问题：将EmailConfig定义为静态全局可变的Properties对象，Tomcat处理并发请求时多线程同时读写该对象会触发并发冲突，产生不可预期的运行时异常。
• 会话创建方式存在隐患：使用Session.getDefaultInstance创建邮件会话，该方法会复用JVM中已存在的会话实例，即使你修改了配置参数也不会生效，容易出现配置不生效的问题。
• 额外配置问题：Gmail已不支持使用普通账号密码登录SMTP服务，必须开启账号两步验证后生成应用专用密码作为SMTP登录凭证，普通密码即使填写正确也会认证失败；另外你写的重置链接是相对路径recoverpage.html，用户收到邮件后点击无法跳转到你的服务页面。

邮件发送类 #

import javax.mail.*;
import javax.mail.internet.*;
import java.util.*;

public class EmailSender {
    // 移除静态全局配置，每次发信时创建独立配置对象，避免并发问题
    public static void sendEmail(String toEmailAddress, String emailSubject, String resetAbsoluteUrl) throws MessagingException {
        // 替换为实际发信账号信息，密码需使用Gmail生成的应用专用密码
        final String username = "你的发信Gmail账号@gmail.com";
        final String password = "你的Gmail应用专用密码";

        Properties emailConfig = new Properties();
        emailConfig.put("mail.smtp.host", "smtp.gmail.com");
        emailConfig.put("mail.smtp.port", "587");
        emailConfig.put("mail.smtp.auth", "true");
        emailConfig.put("mail.smtp.starttls.enable", "true");
        // 增加超时配置避免请求长时间阻塞
        emailConfig.put("mail.smtp.connectiontimeout", 5000);
        emailConfig.put("mail.smtp.timeout", 5000);

        // 使用getInstance替代getDefaultInstance，避免旧会话缓存导致配置不生效
        Session session = Session.getInstance(emailConfig,
                new javax.mail.Authenticator(){
                    @Override
                    protected PasswordAuthentication getPasswordAuthentication() {
                        return new PasswordAuthentication(username, password);
                    }
                });

        MimeMessage msg = new MimeMessage(session);
        msg.addRecipient(Message.RecipientType.TO, new InternetAddress(toEmailAddress));
        // 发件人地址必须和认证账号保持一致
        msg.setFrom(new InternetAddress(username));
        // 指定编码避免中文主题乱码
        msg.setSubject(emailSubject, "UTF-8");
        // 拼接绝对路径的重置链接，指定内容编码避免HTML乱码
        String content = "<html><body>点击链接重置密码：<a href='" + resetAbsoluteUrl + "'>重置密码</a></body></html>";
        msg.setContent(content, "text/html;charset=UTF-8");
        // 核心：调用send方法执行实际发信
        Transport.send(msg);
    }
}

Maven依赖配置 #

你当前使用的依赖版本不存在兼容问题，可以直接保留：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

• 在JAX-RS接口层调用sendEmail方法时，必须做异常捕获，返回明确的业务提示（如“邮件发送失败，请稍后重试”），不要让异常直接抛到Tomcat容器，避免返回无业务含义的500错误页。
• 传入的重置链接必须是带服务域名的绝对路径（例如https://你的域名/recoverpage.html?token=xxx），不要使用相对路径。
• 不要将邮箱账号、密码硬编码在业务代码中，建议放到项目外部配置文件中统一维护。

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