异常教程

Servlet 发送电子邮件（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Web 开发中，发送电子邮件是一个常见且重要的功能，例如用户注册验证、密码重置通知、订单确认等场景都需要通过程序自动发送邮件。Servlet 作为 Java Web 开发的核心组件，能够与邮件服务无缝集成，帮助开发者快速实现这一需求。本文将从零开始讲解如何通过 Servlet 发送电子邮件，涵盖技术原理、代码实现、实际案例以及常见问题的解决方案，适合编程初学者和中级开发者逐步掌握这项技能。

一、发送邮件的基本原理

1.1 电子邮件的传输过程

电子邮件的传输依赖于 SMTP（Simple Mail Transfer Protocol） 协议，可以将其类比为“快递公司”。当用户通过客户端（如浏览器或邮件客户端）发送邮件时，客户端会将邮件内容通过 SMTP 协议发送到 邮件服务器（相当于快递公司的中转站）。邮件服务器再根据收件人地址，将邮件转发到对应的收件方邮件服务器，最终存入收件人的邮箱。

1.2 Servlet 在其中的角色

Servlet 是服务器端的 Java 程序，它可以作为“邮件客户端”，通过调用 JavaMail API（Java 的邮件处理库）与 SMTP 服务器通信。例如，当用户提交表单后，Servlet 接收请求，构建邮件内容，并通过 JavaMail 发送到指定的 SMTP 服务器。

1.3 关键组件说明

  • JavaMail API：Java 提供的邮件发送核心库，支持 SMTP、POP3、IMAP 等协议。
  • Activation Framework：JavaMail 依赖的底层库，用于动态加载邮件服务提供者。
  • SMTP 服务器：例如 Gmail 的 SMTP 服务器地址为 smtp.gmail.com，需要配置端口和认证信息。

二、开发环境准备

2.1 添加 Maven 依赖

在 Maven 项目中，需要引入 JavaMail 和 Activation 的依赖。在 pom.xml 中添加以下代码：

<dependencies>
    <!-- JavaMail 依赖 -->
    <dependency>
        <groupId>com.sun.mail</groupId>
        <artifactId>javax.mail</artifactId>
        <version>1.6.2</version>
    </dependency>
    <!-- Activation Framework 依赖 -->
    <dependency>
        <groupId>javax.activation</groupId>
        <artifactId>activation</artifactId>
        <version>1.1.1</version>
    </dependency>
</dependencies>

注意：不同版本的 JavaMail 可能兼容性不同，建议使用 1.6.2 或更高版本。

2.2 配置 SMTP 服务器信息

以 Gmail 的 SMTP 服务器为例，需要以下信息：

  • 服务器地址：smtp.gmail.com
  • 端口号：通常为 465（SSL 加密）或 587（TLS 加密）
  • 用户名和密码：发送方的 Gmail 账户信息
  • 是否启用 SSL/TLS：Gmail 要求开启 SSL 或 TLS 加密

提示：如果使用其他邮箱服务商（如 163 邮箱），需查询其对应的 SMTP 配置。

三、编写 Servlet 实现邮件发送

3.1 步骤分解

  1. 初始化邮件会话：通过 Session 类配置 SMTP 服务器和认证信息。
  2. 构建邮件对象：使用 MimeMessage 类定义发件人、收件人、主题和正文。
  3. 发送邮件：调用 Transport.send() 方法触发发送动作。
  4. 异常处理：捕获网络或认证错误，并返回友好提示。

3.2 代码实现示例

以下是一个完整的 MailServlet 示例：

import javax.mail.*;
import javax.mail.internet.*;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Properties;

@WebServlet("/sendMail")
public class MailServlet extends HttpServlet {
    private static final String USERNAME = "your-email@gmail.com"; // 发件人邮箱
    private static final String PASSWORD = "your-password"; // 发件人密码

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) 
            throws ServletException, IOException {
        // 1. 获取请求参数（如收件人邮箱、主题、内容）
        String to = request.getParameter("to");
        String subject = request.getParameter("subject");
        String body = request.getParameter("body");

        try {
            // 2. 配置 SMTP 服务器信息
            Properties props = new Properties();
            props.put("mail.smtp.auth", "true"); // 启用认证
            props.put("mail.smtp.starttls.enable", "true"); // 启用 TLS 加密
            props.put("mail.smtp.host", "smtp.gmail.com");
            props.put("mail.smtp.port", "587");

            // 3. 创建邮件会话
            Session session = Session.getInstance(props, new Authenticator() {
                @Override
                protected PasswordAuthentication getPasswordAuthentication() {
                    return new PasswordAuthentication(USERNAME, PASSWORD);
                }
            });

            // 4. 构建邮件消息
            Message message = new MimeMessage(session);
            message.setFrom(new InternetAddress(USERNAME));
            message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to));
            message.setSubject(subject);
            message.setText(body);

            // 5. 发送邮件
            Transport.send(message);
            response.getWriter().write("邮件发送成功！");

        } catch (MessagingException | IOException e) {
            response.getWriter().write("邮件发送失败：" + e.getMessage());
        }
    }
}

3.3 代码关键点解析

  • 认证机制：通过 Authenticator 类提供用户名和密码，确保安全连接。
  • TLS 加密：设置 mail.smtp.starttls.enable 为 true，避免明文传输数据。
  • MimeMessage 的扩展性：若需发送 HTML 内容或附件，可替换 setText() 为 setContent() 并设置 multipart 对象。

四、实际案例：用户注册验证码发送

4.1 场景描述

假设有一个用户注册页面，当用户提交表单后，Servlet 需要生成随机验证码并发送到用户邮箱。

4.2 HTML 表单示例

<form action="/sendMail" method="post">
    <input type="email" name="to" placeholder="请输入邮箱" required>
    <button type="submit">发送验证码</button>
</form>

4.3 修改后的 Servlet 代码

// 在 MailServlet 的 doPost 方法中
// 生成 6 位随机验证码
String verificationCode = String.valueOf((int)(Math.random() * 899999) + 100000);
body = "您的验证码是：" + verificationCode + "，有效期为 5 分钟。";

// 可选：将验证码存入 Session 或 Redis，供后续验证
request.getSession().setAttribute("code", verificationCode);

提示：实际开发中，验证码需设置过期时间，并加密存储。

五、高级技巧与优化

5.1 发送 HTML 格式邮件

通过 MimeMessage 的 setContent() 方法和 MimeMultipart 对象，可以发送富文本内容：

MimeBodyPart messageBodyPart = new MimeBodyPart();
messageBodyPart.setContent("<h1>欢迎注册！</h1><p>您的验证码：<strong>" + verificationCode + "</strong></p>", "text/html");
MimeMultipart multipart = new MimeMultipart();
multipart.addBodyPart(messageBodyPart);
message.setContent(multipart);

5.2 添加附件

// 创建附件部分
MimeBodyPart attachmentPart = new MimeBodyPart();
DataSource source = new FileDataSource("report.pdf");
attachmentPart.setDataHandler(new DataHandler(source));
attachmentPart.setFileName("附件：用户报告.pdf");

// 添加到多部分消息中
multipart.addBodyPart(attachmentPart);

5.3 SSL 加密配置

若使用 SSL 协议，需修改配置并调整端口：

props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.put("mail.smtp.socketFactory.port", "465"); // SSL 端口
props.put("mail.smtp.port", "465");

六、常见问题与解决方案

6.1 错误：javax.mail.AuthenticationFailedException

原因：邮箱密码错误，或未开启“允许不够安全的应用”权限（如 Gmail）。
解决：

  1. 检查密码是否正确；
  2. 在 Gmail 设置中启用“允许不够安全的应用”或生成“应用专用密码”。

6.2 错误：ConnectException: Connection refused

原因：防火墙或网络问题阻止了连接。
解决：

  1. 确认 SMTP 服务器地址和端口是否正确；
  2. 检查服务器是否允许外部连接（如公司内网可能限制 SMTP 端口）。

6.3 邮件进入垃圾箱

原因：收件服务器将邮件标记为垃圾邮件。
解决：

  1. 确保发件邮箱无历史垃圾邮件记录；
  2. 在邮件内容中添加明确的退订链接或公司信息。

结论

通过本文的讲解，读者可以掌握如何利用 Servlet 和 JavaMail API 实现电子邮件的发送功能。从基础原理到代码实现，再到实际案例和问题排查，逐步构建了一个完整的解决方案。对于初学者，建议先通过简单案例熟悉流程；中级开发者则可以探索 HTML 邮件、附件支持等高级功能。

电子邮件发送功能是 Web 应用中用户交互的重要一环，掌握这一技能不仅能提升开发效率，还能为后续构建更复杂的系统（如自动化通知、营销系统）打下基础。希望本文能帮助读者在实践中快速上手，并根据需求灵活调整代码逻辑。

关键词布局：在本文中，“Servlet 发送电子邮件”作为核心主题贯穿始终，通过技术原理、代码示例和实际场景的结合，自然覆盖了这一关键词，同时兼顾了 SEO 的关键词密度和语义优化。

最新发布

查看更多文章