如何在Tomcat 10中通过JNDI配置Jakarta Mail/Angus Mail？

你遇到的问题核心是JNDI配置的邮件会话参数未生效，导致Jakarta Mail fallback到默认的localhost:25连接。以下是错误排查点和正确配置步骤：

常见错误原因 #

1. 资源参数名不符合Jakarta Mail规范，比如用了非标准参数名（如smtpHost而非mail.smtp.host）
2. Resource的type属性写错（比如用了旧的javax.mail.Session而非jakarta.mail.Session）
3. 仍在使用已废弃的ResourceParams标签配置参数，Tomcat当前版本推荐直接将参数作为Resource的属性
4. JNDI lookup时名称不匹配（未加java:comp/env前缀或名称与配置不一致）

正确配置步骤 #

1. Tomcat conf/server.xml（全局命名资源） #

在<GlobalNamingResources>节点下添加邮件会话资源，参数直接写在Resource标签内，使用Jakarta Mail标准参数名：

<GlobalNamingResources>
    <!-- 保留原有全局资源 -->
    <Resource name="mail/GlobalMailSession"
              auth="Container"
              type="jakarta.mail.Session"
              mail.smtp.host="你的SMTP服务器地址"
              mail.smtp.port="587" <!-- 常用端口：587/465 -->
              mail.smtp.auth="true"
              mail.smtp.starttls.enable="true" <!-- 若用SSL则配置mail.smtp.ssl.enable="true" -->
              mail.smtp.user="你的邮箱账号"
              mail.smtp.password="你的邮箱授权码/密码"
              factory="org.apache.naming.factory.MailSessionFactory"/>
</GlobalNamingResources>

2. Tomcat conf/context.xml（映射全局资源到应用） #

添加ResourceLink，将全局资源映射到应用可访问的JNDI命名空间：

<Context>
    <!-- 保留原有配置 -->
    <ResourceLink name="mail/AppMailSession"
                  global="mail/GlobalMailSession"
                  type="jakarta.mail.Session"/>
</Context>

3. 应用WEB-INF/web.xml（声明资源引用） #

添加resource-ref，告知应用服务器该JNDI资源的存在：

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0">
    <!-- 保留原有web配置 -->
    <resource-ref>
        <description>应用邮件会话</description>
        <res-ref-name>mail/AppMailSession</res-ref-name>
        <res-type>jakarta.mail.Session</res-type>
        <res-auth>Container</res-auth>
    </resource-ref>
</web-app>

4. Java代码获取Session #

修改EmailService的构造方法，使用正确的JNDI名称获取会话（注意必须加java:comp/env前缀）：

import jakarta.mail.Session;
import javax.naming.InitialContext;
import javax.naming.NamingException;

public class EmailService {
    private Session mailSession;

    public EmailService() {
        try {
            InitialContext ctx = new InitialContext();
            // 名称需与web.xml中res-ref-name一致，前缀java:comp/env不可省略
            mailSession = (Session) ctx.lookup("java:comp/env/mail/AppMailSession");
        } catch (NamingException e) {
            e.printStackTrace();
            throw new RuntimeException("JNDI获取邮件会话失败", e);
        }
    }

    // 发送邮件逻辑与手动初始化时一致，直接使用mailSession创建MimeMessage即可
    public void sendEmail(String to, String subject, String content) {
        // ... 你的邮件发送代码
    }
}

验证要点 #

• 确保Tomcat的lib目录下只有你提到的三个Jakarta相关Jar包，无旧的javax.mail或activation Jar包冲突
• 修改配置后需重启Tomcat，确保配置生效
• 若仍有问题，检查Tomcat日志（如localhost.log），查看JNDI资源加载是否有报错信息

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