1. 项目概述1.1 这个需求背后的真实场景说到Java Web发邮件很多刚入行的同学第一反应是拿个Spring Boot项目加个starter填几个配置一个JavaMailSender注入进来就能跑了。但如果你还在学原生Servlet、JSP的老一套技术栈或者你所在项目有尽量不引入框架依赖的约束那原生Java Web实现邮件发送这个需求就会突然变得不那么轻松。我这次做的东西就是在这个背景下展开的一个纯Servlet JavaMail API实现的邮件发送功能页面提交表单后端接到请求后通过SMTP协议把邮件发出去。没有Spring没有Maven插件没有一堆自动配置每一步都手动拼起来。这种做法的价值在于它能让你真正理解一封邮件从浏览器表单到对方收件箱之间到底经历了哪些环节而不是被框架的黑盒隐藏起来。这套代码适合谁参考三类人第一类是正在学Java Web、想搞明白Servlet如何承接请求并完成任务的同学第二类是在校做课程设计、需要一个完整可演示的邮件发送模块的开发者第三类是工作中遇到了不能用框架、必须原生实现这种约束需要快速落地的工程师。看完这篇文章你能拿到可以直接跑起来的源码也能明白文件编码问题、SMTP认证失败、端口不通这些坑是怎么踩出来的。1.2 准备聊哪些内容文章会分为这样几个部分先说邮件发送涉及的基础知识——SMTP协议是什么、JavaMail API和它的依赖关系然后讲我如何规划项目结构和关键配置接着给出完整源码逐段拆解发送逻辑再聊Servlet如何接入Http请求以及JSP页面上的表单细节最后把实际开发中遇到的典型问题和排查思路整理成清单。每个段落都会附带我在动手过程中的实际操作记录和经验体会不是纯理论都是可复现的步骤。2. 邮件发送的核心机制与JavaMail选型2.1 SMTP协议到底是干什么的邮件发送这件事本质上就是你的程序作为邮件客户端把一封构造好的邮件扔给一台SMTP服务器再由这台服务器负责把邮件投递到收件人的邮件服务器上。整个过程遵循SMTP协议——Simple Mail Transfer Protocol简单邮件传输协议。它定义了两台服务器之间、客户端与服务器之间的对话规则。你可以把SMTP服务器想象成一个快递中转站。你写好了包裹邮件填好了收件人地址收件邮箱然后把它交给中转站SMTP服务器中转站根据地址去投递。如果收件人邮箱恰好也在同一家中转站的管辖范围那它直接投进对方信箱如果不在它会转交给下一个中转站。发邮件这个动作从用户视角看只是点了发送按钮但背后经历了至少一次TCP连接、一次身份认证通常需要、一次邮件数据传输。第三方免费邮箱提供的SMTP服务器通常会在服务器上开一个认证机制。你用自己的邮箱账号去登录对方服务器通过验证之后才允许发信。这也是为什么实际开发中你几乎不可能只写代码就能把邮件发出去——你必须有一个真实的、开启了SMTP服务权限的邮箱账户。大多数主流邮箱厂商默认不开放这个功能需要你手动在设置里开启SMTP/POP3/IMAP服务然后生成一个授权码而非直接使用登录密码。这个细节非常关键我第一次测试时用账号密码直接认证服务器返回535错误查了半天才意识到要用授权码。2.2 JavaMail API的结构与依赖Java原生发邮件依赖的核心API是javax.mail包这是JavaEE规范中JavaMail的一部分。它不是JDK自带的需要额外引入两个JAR包mail.jar提供Session、Message、Transport等主要类activation.jar处理MIME类型数据的辅助包比如附件、图片内嵌这类二进制的数据如果你的项目用Maven管理依赖引入这两个坐标就行但如果是原生Servlet项目、没有Maven那你得手动把JAR包放在WEB-INF/lib目录下。我在开发时使用的是最传统的手动部署方式——自己在本地下载了mail.jar和activation.jar放在lib目录然后让Tomcat在启动时加载它们。这种方式的好处是完全可控不用依赖网络构件仓库对课程设计或者内网开发环境非常友好。JavaMail API工作的核心对象有三个Session整个邮件会话的配置中心持有服务器地址、端口、认证开关、网络超时这些参数MimeMessage代表一封邮件负责组装发件人、收件人、主题、正文、附件Transport真正把MimeMessage发给SMTP服务器并完成数据传输的通道这三者的关系可以简化理解为一个类似快递流程你(Session)约好了快递公司SMTP服务器的规矩填好快递单MimeMessage然后交给快递员Transport带走。在后面的代码部分你就能看到这三者依次登场。2.3 为什么不用第三方SDK而自己写现在很多云服务商提供了HTTP接口发邮件的SDK比如通过API密钥调用发信接口代码量更小、送达率也更高。那为什么我这次坚持用原生JavaMail原因很简单题目要求是原生JavaWeb实现这是技术学习路径上必须走的一步。用云服务商的SDK屏蔽了底层的SMTP交互学习价值大打折扣。而手工写JavaMail代码你能看清SMTP服务器的连接是Socket层面的TCP通信邮件内容本质上是MIME格式的文本数据附件是多段MIME结构拼接起来的这些底层认知对于将来调试复杂的邮件问题——比如附件格式错乱、邮件被识别为垃圾内容——会提供很大的帮助。当然如果项目上线到生产环境我的建议还是优先用成熟的邮件服务商或者企业内部邮件服务器原生JavaMail更适合学习和可控的自建场景。后者在投递成功率、反垃圾评分上靠的是背后整个基础设施的积累。3. 项目结构和基础配置准备3.1 项目目录怎么组织我这次的项目结构完全按照Servlet规范的标准布局来没有多余的花架子。核心文件有这些mail-demo/ ├── src/ │ └── com/example/mail/ │ ├── MailSender.java // 邮件发送核心逻辑 │ ├── SendMailServlet.java // 接收表单请求的Servlet │ └── MailConfig.java // 邮件配置常量服务器、账号、授权码 ├── web/ │ ├── WEB-INF/ │ │ ├── lib/ │ │ │ ├── mail.jar │ │ │ └── activation.jar │ │ └── web.xml │ └── sendMail.jsp // 发送页面这个结构是手动建出来的没有用IDE的Web项目向导。之所以手动搭是因为很多初学者在IDE里点新建Dynamic Web Project时会面临各种版本兼容的选项错误反而不如自己动手创建目录、自己写web.xml来得清晰。当然你在IDEA里用Project Structure新建Web项目也是可以的只要保证最终部署出来的目录结构满足Servlet规范即可。还有一点要提前说清楚WEB-INF目录下的东西是Web容器保护的外部不能通过URL直接访问。所以mail.jar和activation.jar放在WEB-INF/lib下能被Tomcat自动加载而用户无法通过http://ip:8080/mail-demo/mail.jar下载到它。这个机制是Servlet规范定义的保证依赖库的私密性。3.2 需要的JAR包怎么获取前面提到的两个JAR包获取途径很常规。mail.jar可以在Oracle官网的JavaMail页面下载也可以从Maven中央仓库直接下载jar包文件。activation.jar同样可以在Maven中央仓库获取搜索javax.activation即可。需要注意的是版本问题JavaMail版本建议选1.4.7这是公认稳定且资料多的版本activation建议选1.1.1。高版本的jakarta.mail是另一套命名空间jakarta.mail包跟传统的javax.mail不兼容如果项目还是老式Servlet容器Tomcat 8/9那用javax.mail的命名空间就够了不用追新。如果你用的是Maven直接在pom.xml中配置dependency groupIdjavax.mail/groupId artifactIdmail/artifactId version1.4.7/version /dependency dependency groupIdjavax.activation/groupId artifactIdactivation/artifactId version1.1.1/version /dependency这里有一个容易踩的坑不同版本的mail.jar依赖的activation.jar版本可能不同如果不匹配运行时会出现ClassNotFoundException: com.sun.activation.registries.MailcapFile这类错误。我自己的做法是干脆两个JAR都从同一个来源下载比如Maven仓库中的配套版本避免版本错位。3.3 关键配置参数解释在做邮件发送之前先要摸清你选择的邮箱服务商提供的基础参数。不同的邮件服务商SMTP服务器地址和端口可能不一样常见的配置模式有普通SSL加密模式smtp.xxx.com端口465需要开启SSL升级TLS模式smtp.xxx.com端口587需要STARTTLS我实际操作时优先使用465端口SSL模式因为587端口在有些服务器环境下会被运营商封锁或者邮件服务商默认不允许非加密连接。465这种SSL直连模式更省事只需要在Properties设置mail.smtp.ssl.enabletrue即可。除了服务器和端口还要准备好你的完整邮箱地址作为发件人地址授权码在邮箱设置中开启SMTP后生成的一串独立密码收件人邮箱测试时最好用另一个不同域名下的邮箱这样能验证跨服务器投递是否正常我给项目加了一个MailConfig类来统一存放这些常量避免在代码里到处写死。这个问题虽然简单但做得好不好直接影响后面维护的体验——我见过不少项目把邮箱密码散落在七八个类里改一次授权码要全局搜索非常痛苦。4. 核心代码实现详解4.1 MailSender类——邮件发送的骨架先给出这个类的完整代码这是整个项目中最核心的部分package com.example.mail; import java.util.Properties; import javax.mail.Authenticator; import javax.mail.Message; import javax.mail.MessagingException; import javax.mail.PasswordAuthentication; import javax.mail.Session; import javax.mail.Transport; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; public class MailSender { public static void send(String to, String subject, String content) throws MessagingException { Properties props new Properties(); // SMTP服务器地址 props.put(mail.smtp.host, MailConfig.SMTP_HOST); // 端口 props.put(mail.smtp.port, MailConfig.SMTP_PORT); // 是否开启认证 props.put(mail.smtp.auth, true); // 是否开启SSL props.put(mail.smtp.ssl.enable, true); // 设置超时时间避免服务器无响应时客户端卡死 props.put(mail.smtp.connectiontimeout, 10000); props.put(mail.smtp.timeout, 10000); Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(MailConfig.USERNAME, MailConfig.AUTH_CODE); } }); // 打开调试模式方便观察SMTP协议交互过程 session.setDebug(true); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(MailConfig.USERNAME)); message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); message.setSubject(subject, UTF-8); message.setContent(content, text/html;charsetUTF-8); Transport.send(message); } }这段代码里值得逐行解释的地方不少。先看Session.getInstance(props, authenticator)这一行props里配置了连接SMTP的所有参数而Authenticator是JavaMail用来获取认证凭据的接口。注意看我在这里返回的不是邮箱的登录密码而是AUTH_CODE授权码。这个设计是JavaMail API的标准用法——通过PasswordAuthentication封装用户名和密码/授权码Transport在连接服务器时会自动使用这组凭据做认证。再看message.setSubject(subject, UTF-8)。这个方法的重载形式很多如果你直接调用setSubject(subject)主题会按默认编码处理中文大概率变成乱码。我特意指定了UTF-8确保中英文都能正确编码。同理正文通过setContent(content, text/html;charsetUTF-8)设置告诉收件人的邮件客户端这是一封HTML格式、UTF-8编码的邮件。如果你想要纯文本格式把第二个参数改成text/plain;charsetUTF-8就行。还有一个容易被忽略的细节session.setDebug(true)。这行代码平时没存在感但当你遇到邮件发不出去这种问题需要排查时它会帮你打印出客户端和SMTP服务器之间的完整对话过程——包括DNS解析、TCP连接、EHLO指令、AUTH LOGIN认证、MAIL FROM指令、RCPT TO指令、DATA指令以及服务器的每个响应码。我第一次排查认证失败问题时就是依靠这个输出看到了服务器返回的错误码才定位到授权码的问题。上线部署时记得把setDebug改成false否则会产生大量日志输出。4.2 MailConfig类——统一管理配置有经验的人写代码不会把配置参数分散在业务代码里。我单独抽了个MailConfig类package com.example.mail; public class MailConfig { // SMTP服务器地址 public static final String SMTP_HOST smtp.yourmailservice.com; // 端口SSL加密连接常用465 public static final String SMTP_PORT 465; // 发件人邮箱地址 public static final String USERNAME your_accountexample.com; // 授权码不是登录密码 public static final String AUTH_CODE xxxxxxxxxxxxxx; }这个类的作用不言自明当你的部署环境切换时比如从测试邮箱切换到公司内部邮件服务器只需要改这一个文件当授权码过期需要替换时也只需要改这一个地方。这里有个建议如果你要把项目推到Git仓库上务必在.gitignore中排除这个文件或者在提交前将真实授权码替换成占位符——否则授权码泄露别人就能用你的邮箱发邮件轻则被当作垃圾邮件源重则影响邮箱安全。4.3 SendMailServlet——接收请求的核心入口Servlet在Java Web开发中扮演的角色就是接受HTTP请求、执行业务逻辑、返回响应视图。我这里创建了一个SendMailServlet只负责接收页面表单的POST请求并调用MailSenderpackage com.example.mail; import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; WebServlet(/sendMail) public class SendMailServlet extends HttpServlet { private static final long serialVersionUID 1L; Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); response.setContentType(text/html;charsetUTF-8); String to request.getParameter(to); String subject request.getParameter(subject); String content request.getParameter(content); if (to null || to.trim().isEmpty() || subject null || subject.trim().isEmpty()) { request.setAttribute(message, 收件人、主题不能为空); request.getRequestDispatcher(sendMail.jsp).forward(request, response); return; } try { MailSender.send(to.trim(), subject.trim(), content); request.setAttribute(message, 邮件发送成功); } catch (Exception e) { e.printStackTrace(); request.setAttribute(message, 邮件发送失败 e.getMessage()); } request.getRequestDispatcher(sendMail.jsp).forward(request, response); } }注意编码问题我在doPost第一行就设置了request.setCharacterEncoding(UTF-8)。这个调用必须在读取任何请求参数之前执行否则Tomcat会按默认的ISO-8859-1来解码POST请求体中文表单提交就会出现乱码。这个细节初学者特别容易踩坑——我见过很多人在页面已经设置了UTF-8但后台收到的参数依然是乱码的情况原因就是漏了这行。另外我做了基本的非空校验只校验了收件人和主题没对邮箱格式做正则校验。正常开发中收件人格式校验是很基本的——邮箱里注入垃圾内容导致发信失败事小如果将来做批量发送功能格式错误可能引发异常退信。后面在升级篇中我会展示一个简单的验证方式。4.4 sendMail.jsp——前端提交界面最后需要一个交互页面。我这里用JSP实现通过简单的HTML表单提交数据% page contentTypetext/html;charsetUTF-8 languagejava % html head title邮件发送/title style body { font-family: Microsoft YaHei, sans-serif; background: #f5f5f5; } .container { width: 600px; margin: 50px auto; background: #fff; padding: 30px; border-radius: 8px; } label { display: block; margin-top: 15px; font-weight: bold; } input[typetext], textarea { width: 100%; padding: 8px; margin-top: 5px; border: 1px solid #ccc; border-radius: 4px; } textarea { height: 120px; } button { margin-top: 20px; padding: 10px 30px; background: #409eff; color: #fff; border: none; border-radius: 4px; cursor: pointer; } /style /head body div classcontainer h2发送邮件/h2 p stylecolor: red;${message}/p form actionsendMail methodpost label收件人邮箱/label input typetext nameto placeholdersomeoneexample.com label邮件主题/label input typetext namesubject placeholder邮件主题 label邮件内容/label textarea namecontent placeholder请输入邮件正文内容/textarea button typesubmit发送/button /form /div /body /html表单的提交方式必须是post因为邮件发送会改变服务器状态而且邮件主题和正文可能包含较长的内容POST在数据大小限制和语义上都更合适。表单的action指向sendMail这个映射在Servlet代码中是通过WebServlet(/sendMail)注解定义的——如果用低版本的Servlet容器注解可能不支持你需要再去web.xml里声明Servlet映射我这次使用的是Servlet 3.0直接走注解。页面上用了${message}来显示后端返回的结果这要求JSP默认支持EL表达式。大部分Tomcat配置都是支持的如果显示原样${message}那是开了忽略EL的配置可以在JSP顶部加% page isELIgnoredfalse %解决。5. 部署运行与完整验证流程5.1 部署到Tomcat部署过程我是这样操作的先确保本地已经安装了Tomcat 8或9然后把整个项目导出为WAR包或者直接把项目目录丢到Tomcat的webapps目录下。如果你用的是IDEA可以在Run Configuration里配置Tomcat Server把项目部署到Tomcat后点击运行。启动过程中有几点要特别注意Tomcat启动时会在日志中打印部署信息如果WEB-INF/lib下的JAR包没有正确加载你会看到ClassNotFoundException异常那多半是lib目录路径不对或者JAR包缺失如果出现端口占用检查是否有其他Tomcat实例在运行可以在conf/server.xml中改端口浏览器访问路径通常是http://localhost:8080/mail-demo/sendMail.jsp这里mail-demo是你的上下文路径也就是WAR包名或项目名启动完成后页面能正常显示就可以开始测试发送了。5.2 功能验证步骤我的验证流程是这样的开两个邮箱一个作为发件方一个作为收件方两个邮箱都用不同域名这样才能检验跨服务器投递。然后我在页面上分别填写收件人recipientotherdomain.com主题JavaMail原生发送测试内容h2这是HTML内容/h2p这是一封来自原生JavaWeb项目的邮件。/p点击发送后如果页面显示邮件发送成功再去看收件方邮箱是否收到。为了确认整个链路完整我在MailSender中开着setDebug(true)控制台会打印出一大段SMTP协议交互日志。关键的日志片段类似DEBUG SMTP: Connected to host: smtp.xxx.com, port: 465 DEBUG SMTP: AUTH LOGIN command mixed with SSL DEBUG SMTP: Use 8bit NTLM DEBUG SMTP: AUTH LOGIN succeeded DEBUG SMTP: MAIL FROM:your_accountexample.com DEBUG SMTP: RCPT TO:recipientotherdomain.com DEBUG SMTP: DATA当看到AUTH LOGIN succeeded和RCPT TO成功返回时基本可以判断邮件已经进入投递流程。等收件方邮箱收到邮件说明整个链路是通的。5.3 控制台日志怎么看很多同学面对一大段Debug日志会发懵我在这里简单说一下怎么看。SMTP协议的命令都是有迹可循的220开头的行服务器打招呼说明TCP连接成功250开头的行请求被接受比如EHLO、MAIL FROM、RCPT TO成功334开头的行服务器要求提供认证信息用户名/密码235开头的行认证成功535开头的行认证失败常见原因是授权码错误554开头的行发送被拒绝可能是内容触发反垃圾策略把这几个状态码记住绝大多数邮件发送问题都能在日志中直接定位。我也是用这个方法调通了整个项目后面要分享的几个坑也全都靠日志才排查清楚。6. 常见问题与排查技巧实录6.1 授权码错误的经典报错第一次测试时我在发件人配置中填了真正的邮箱登录密码结果控制台打出如下错误javax.mail.AuthenticationFailedException: 535 Error: authentication failed排查步骤很简单先确认邮箱是否已开启SMTP服务再确认授权码是否有效。多数邮箱开启SMTP服务后会明确提示授权码仅显示一次, 需要妥善保存如果遗忘了只能重新生成。把配置里的AUTH_CODE换成新授权码问题就解决了。这是一个很多人会犯的错误因为登录密码和授权码是两个不同的东西登录密码只能在网页Web端使用授权码是专门提供给第三方客户端使用的。所以拿到一个发不出去邮件的报错先别慌着改代码先检查认证凭据。6.2 端口不通的排查记录另一次测试中我配置了SMTP端口为25这是SMTP协议的默认端口但在部分网络环境下25端口会被ISP封锁日志显示连接超时java.net.ConnectException: Connection timed out: connect排查方法是先用telnet smtp.xxx.com 25测试端口连通性。如果telnet连接不了果断换成465或587端口。服务器防火墙规则、云服务商安全组这些网络层面因素都可能导致端口不通。实际使用时我用465端口一切正常25端口则出现超时。这里有个经验如果你部署在云服务器上还要检查安全组规则是否放行了对应出方向端口。大部分云厂商默认放行所有出方向端口但在部分企业内网环境需要向网络管理员申请开通。6.3 中文乱码问题根因分析中文乱码是另一个高频问题。问题出现的现象是收件方收到邮件后主题显示问号或乱码正文中的中文也成了乱码。根因在于编码设置不一致。处理方法就是我前面代码中体现的JSP页面声明UTF-8表单提交前使用UTF-8编码Servlet中调用request.setCharacterEncoding(UTF-8)在读取参数之前执行setSubject指定UTF-8参数setContent声明text/html;charsetUTF-8四个环节缺一不可。我在JSP页面里还特意给表单加了accept-charsetUTF-8属性虽然现代浏览器默认会按页面编码提交但多这一层保险总没有坏处。另外一个隐蔽的坑是如果你的项目部署在Windows服务器上系统默认字符集是GBK某些文件的编码如果被IDE用系统默认字符集保存了JSP编译出来就会出乱码。这种情况可以在server.xml中的Connector标签添加URIEncodingUTF-8属性确保GET请求参数的编码也正确。6.4 频繁发送触发限流策略测试时如果短时间内连续发送多封邮件可能会触发邮箱服务商的反垃圾策略。服务器会返回类似这样的错误554 Transaction failed这时不能继续重试否则可能被封禁发信权限。正确做法是放慢发送频率每次间隔至少一两分钟如果是正式项目需要批量发送建议设计异步队列控制发送速率和日发送量上限。个人邮箱的日发送配额通常有限不建议拿个人邮箱做大规模生产发信。6.5 常见错误码速查表为了方便排查我把一些常见问题整理成了表格现象可能原因解决思路535认证失败授权码错误重新生成授权码并更新配置Connection timed out端口不通、防火墙拦截telnet测试端口更换465端口Could not connect to SMTP host服务器地址配置错误检查邮箱服务商SMTP地址550 Mailbox not found收件人地址不存在确认收件人邮箱拼写554 Transaction failed内容触发反垃圾策略降低发送频率检查邮件内容主题显示乱码setSubject未指定编码使用setSubject(subject, UTF-8)页面表单中文乱码Servlet未调用setCharacterEncoding在读取参数前设置UTF-8这张表可以贴在你项目的README里后续维护时候查起来很方便。7. 进阶扩展与个人经验总结7.1 如何加入附件支持现在实现的版本只支持纯文本和HTML内容。如果业务需要支持附件你需要在原来的MimeMessage基础上使用MimeMultipart和MimeBodyPart构造复合消息。MimeMultipart multipart new MimeMultipart(); // 正文部分 MimeBodyPart textPart new MimeBodyPart(); textPart.setContent(content, text/html;charsetUTF-8); multipart.addBodyPart(textPart); // 附件部分 MimeBodyPart filePart new MimeBodyPart(); DataSource source new FileDataSource(filePath); filePart.setDataHandler(new DataHandler(source)); filePart.setFileName(MimeUtility.encodeText(fileName, UTF-8, B)); multipart.addBodyPart(filePart); message.setContent(multipart);这里有个关键点setFileName需要进行MIME编码处理否则中文文件名在收件人那里会变成乱码。MimeUtility.encodeText帮我们把中文转换为符合MIME规范的编码。如果不做这步收件人下载附件时文件名就会显示成乱码——这个问题我实际测试时遇到过填入测试报告.pdf后收件人看到的是?UTF-8?B?...?这样的长串令人头大。7.2 支持多收件人与抄送实际业务中一封邮件可能需要发给多个收件人。JavaMail API支持在一条消息上添加多个收件人message.addRecipients(Message.RecipientType.TO, InternetAddress.parse(aexample.com,bexample.com));这里用的是addRecipients复数可以一次解析多个地址用逗号分隔。抄送则是message.addRecipient(Message.RecipientType.CC, new InternetAddress(ccexample.com));7.3 开发中的三点体会最后分享几个我在整个实现过程中的体会这些不是代码层面的知识但我觉得比代码更重要。第一原生实现的最大价值不是不用框架而是让你理解框架帮你做了什么。当你亲手配置Session、看着Authenticator的调用、阅读SMTP协议的调试日志你才真正理解为什么Spring Boot里只要填几行配置邮件就能发出去——因为框架替你封装了这一整条链路。有了这个理解再用框架时你排查问题会精准很多。第二很多奇怪的问题根源都是编码不一致。我做这个项目时中文乱码问题前前后后折腾了大半天从页面排查到Servlet再到JavaMail的设置最后发现是JSP文件本身的编码被IDE存成了GBK。所以项目创建之初就统一设置项目编码为UTF-8文件编码为UTF-8连接数据库、写页面、返回响应都明确指定UTF-8能避免后续大量扯皮。第三调试信息是好朋友别嫌它烦。setDebug(true)打出的日志虽然长但它是你能看到的、客户端和服务器之间的真实对话记录。遇到问题时先看日志再说能省掉大量盲目试错的时间。正式上线时关掉它否则日志文件会快速膨胀。这个项目的后续扩展方向其实不少比如把发件配置移动到数据库表做成后台可以动态管理的功能比如加入发送记录表记录每次发送的时间、收件人、状态再比如做一个定时任务定期处理队列中的待发邮件。每一步扩展都是对JavaWeb技术栈更深入的一次实践。
