1. 前言
互联网发展到现在,邮件服务已经成为互联网企业中必备功能之一,应用场景非常广泛,比较常见的有:用户注册、忘记密码、监控提醒、企业营销等。
大多数互联网企业都会将邮件发送抽取为一个独立的微服务,对外提供接口来支持各种类型的邮件发送。
中国的第一封电子邮件
1987 年 9 月 14 日中国第一封电子邮件是由“德国互联网之父”维纳·措恩与王运丰在当时的兵器工业部下属单位—计算机应用技术研究所(简称 ica)发往德国卡尔斯鲁厄大学的,其内容为德文和英文双语,第一段大意如下:
原文:“ across the great wall we can reach every corner in the world. ”中文大意:“ 越过长城,我们可以到达世界的每一个角落。 ”
这是中国通过北京与德国卡尔斯鲁厄大学之间的网络连接,发出的第一封电子邮件。现在看这封邮件内容,颇具深意!
2. 邮件协议
发送邮件的本质是将一个人的信息传输给另外一个人,那么如何传输就需要商量好标准,这些标准就是协议。最初只有两个协议:
· smtp 协议
smtp 的全称是 “simple mail transfer protocol”,即简单邮件传输协议。它是一组用于从源地址到目的地址传输邮件的规范,通过它来控制邮件的中转方式。它的一个重要特点是它能够在传送中接力传送邮件,即邮件可以通过不同网络上的主机接力式传送。
smtp 认证,简单地说就是要求必须在提供了账户名和密码之后才可以登录 smtp 服务器,这就使得那些垃圾邮件的散播者无可乘之机。增加 smtp 认证的目的是为了使用户避免受到垃圾邮件的侵扰。smtp主要负责底层的邮件系统如何将邮件从一台机器传至另外一台机器。
· pop3 协议
pop3 是 post office protocol 3 的简称,即邮局协议的第3个版本,它规定怎样将个人计算机连接到 internet 的邮件服务器和下载电子邮件的电子协议。
它是因特网电子邮件的第一个离线协议标准,pop3 允许用户从服务器上把邮件存储到本地主机(即自己的计算机)上,同时删除保存在邮件服务器上的邮件。
pop 协议支持“离线”邮件处理。其具体过程是:邮件发送到服务器上,电子邮件客户端调用邮件客户机程序以连接服务器,并下载所有未阅读的电子邮件。
这种离线访问模式是一种存储转发服务,将邮件从邮件服务器端送到个人终端机器上,一般是 pc 机或 mac。
一旦邮件发送到 pc 机或 mac上,邮件服务器上的邮件将会被删除。但目前的 pop3 邮件服务器大都可以“只下载邮件,服务器端并不删除”,也就是改进的 pop3 协议。
smtp 和 pop3 是最初的两个协议,随着邮件的不断发展后来又增加了两个协议:
· imap 协议
全称 internet mail access protocol(交互式邮件存取协议),imap 是斯坦福大学在 1986 年开发的研发的一种邮件获取协议,即交互式邮件存取协议,它是跟 pop3 类似邮件访问标准协议之一。
不同的是,开启了 imap 后,在电子邮件客户端收取的邮件仍然保留在服务器上,同时在客户端上的操作都会反馈到服务器上,如:删除邮件,标记已读等,服务器上的邮件也会做相应的动作。
所以无论从浏览器登录邮箱或者客户端软件登录邮箱,看到的邮件以及状态都是一致的。
imap 的一个与 pop3 的区别是:imap 它只下载邮件的主题,并不是把所有的邮件内容都下载下来,而是你邮箱当中还保留着邮件的副本,没有把你原邮箱中的邮件删除,你用邮件客户软件阅读邮件时才下载邮件的内容。
较好支持这两种协议的邮件客户端有:foxmail、outlook 等。
· mime 协议
由于 smtp 这个协议开始是基于纯 ascⅱ文本的,在二进制文件上处理得并不好。后来开发了用来编码二进制文件的标准,如 mime,以使其通过 smtp 来传输。
今天,大多数 smtp 服务器都支持 8 位 mime 扩展,它使二进制文件的传输变得几乎和纯文本一样简单。
用一张图来看发送邮件过程中的协议使用:
实线代表neo@126 发送邮件给 itclub@aa;虚线代表 itclub@aa 发送邮件给 neo@126
3. 邮件发送流程
发信人在用户代理上编辑邮件,并写清楚收件人的邮箱地址;用户代理根据发信人编辑的信息,生成一封符合邮件格式的邮件;用户代理把邮件发送到发信人的邮件服务器上,邮件服务器上面有一个缓冲队列,发送到邮件服务器上面的邮件都会加入到缓冲队列中,等待邮件服务器上的 smtp 客户端进行发送;发信人的邮件服务器使用 smtp 协议把这封邮件发送到收件人的邮件服务器上收件人的邮件服务器收到邮件后,把这封邮件放到收件人在这个服务器上的信箱中;收件人使用用户代理来收取邮件。首先用户代理使用 pop3 协议来连接收件人所在的邮件服务器,身份验证成功后,用户代理就可以把邮件服务器上面的收件人邮箱里面的邮件读取出来,并展示给收件人。这就是邮件发送的一个完整流程。
4. 简单使用
最早期的时候使用 javamail 相关 api 来开发,需要自己去封装消息体,代码量比较庞大;
后来 spring 推出了 javamailsender 简化了邮件发送过程,javamailsender 提供了强大的邮件发送功能,可支持各种类型的邮件发送。
现在 spring boot 在 javamailsender 的基础上又进行了封装,就有了现在的 spring-boot-starter-mail,让邮件发送流程更加简洁和完善。
下面给大家介绍如何使用 spring boot 发送邮件。
pom 包配置
引入加 spring-boot-starter-mail 依赖包:
配置文件
在 application.properties 中添加邮箱配置,不同的邮箱参数稍有不同,下面列举几个常用邮箱配置:
163 邮箱配置:
126 邮箱配置
qq 邮箱配置如下:
注意:测试时需要将 spring.mail.username 和 spring.mail.password 改成自己邮箱对应的登录名和密码,这里的密码不是邮箱的登录密码,是开启 pop3 之后设置的客户端授权密码。
这里以 126 为邮件举例,有两个地方需要邮箱中设置:
开启 pop3/smtp 服务、imap/smtp 服务
图片下方会有 smtp 等相关信息的配置提示。
开通设置客户端授权密码
设置客户端授权密码一般需要手机验证码验证。
文本邮件发送
spring 已经帮我们内置了 javamailsender,直接在项目中引用即可。我们封装一个 mailservice 类来实现普通的邮件发送方法。
文本邮件抄送使用:message.copyto(copyto) 来实现。
from,即为邮件发送者,一般设置在配置文件中to,邮件接收者,此参数可以为数组,同时发送多人subject,邮件主题content,邮件的主体邮件发送者 from 一般采用固定的形式写到配置文件中。
编写 test 类进行测试
稍微等待几秒,就可以在邮箱中找到此邮件内容了。至此一个简单的文本邮件发送就完成了。
5. 富文本邮件
在日常使用的过程中,我们通常在邮件中加入图片或者附件来丰富邮件的内容,下面讲介绍如何使用 spring boot 来发送富文本邮件。
发送 html 格式邮件
邮件发送支持以 html 语法去构建自定义的邮件格式,spring boot 支持使用 html 发送邮件。
我们在 mailservice 中添加支持 html 邮件发送的方法.
富文本邮件抄送使用:helper.addcc(cc) 来实现。
和文本邮件发送代码对比,富文本邮件发送使用 mimemessagehelper 类。mimemessagehelper 支持发送复杂邮件模板,支持文本、附件、html、图片等,接下来会一一使用到。
在测试类中构建 html 内容,测试发送
邮件内容大写了一段话,下面为接收到的效果:
由此我们发现发送 html 邮件,就是需要拼接一段 html 的 string 字符串交给 mimemessagehelper 来处理,最后由邮件客户端负责渲染显示内容。
发送带附件的邮件
在 mailservice 添加 sendattachmentsmail 方法,发送带附件的邮件主要是使用 filesystemresource 对文件进行封装,在添加到 mimemessagehelper 中。
添加多个附件可以使用多条 helper.addattachment(filename, file)
在测试类中添加测试方法
附件可以是图片、压缩包、word 等任何文件,但是邮件厂商一般都会对附件大小有限制,太大的附件建议使用网盘上传后,在邮件中给出链接。
效果图如下:
发送带静态资源的邮件
邮件中的静态资源一般指图片,在 mailservice 添加 sendinlineresourcemail 方法。
在测试类中添加测试方法
添加多个图片可以使用多条 和helper.addinline(rscid, res) 来实现
效果图如下:
以上是邮件发送的基础服务,已演示支持各种类型邮件。
6. 邮件系统
如果只是想在系统中做一个邮件工具类的话,以上的内容基本就可以满足要求了。要做成一个邮件系统的话还需要考虑以下几方面:
对外提供发送邮件的服务接口固定格式邮件是否考虑使用模板发送邮件时出现网络错误,是否考虑适当的重试机制邮件系统是否考虑异步化,提升服务响应时间是否开发邮件后台管理系统,开发出对应的管理软件,通过页面发送邮件,统计发送邮件成功率等数据。常见异常处理措施6.1 对外提供接口
作为一个独立的邮件系统,需要对外提供接口调用,我们以简单文本邮件为例做个演示:
首先需要定义个实例返回对象:
默认成功的返回码为:00,返回消息为:发送成功。
创建一个 mailcontroller 类对外提供
emailtemplate.html 文件内容即为邮件的正文内容模板。
我们发现上述的模板中只有 id 是一个动态的值,发送过程中会根据传入的 id 值来替换链接中的 {id}。
3. 解析模板并发送
我们发现最后调用的还是 sendhtmlmail 的方法,邮件模板的作用只是处理 html 生成部分,通过 thymeleaf 模板引擎解析固定的模板,再更具参数来动态替换其中的变量,最后通过前面的 html 发送的方法发送邮件。
效果图如下:
点击“激活账号”跳转的链接为:http://ityouknow/register/006
6.3 发送失败
因为各种原因,总会有邮件发送失败的情况,比如:邮件发送过于频繁、网络异常等。在出现这种情况的时候,我们一般会考虑重新重试发送邮件,会分为以下几个步骤来实现:
接收到发送邮件请求,首先记录请求并且入库。调用邮件发送接口发送邮件,并且将发送结果记录入库。启动定时系统扫描时间段内,未发送成功并且重试次数小于3次的邮件,进行再次发送.重新发送邮件的时间,建议以 2 的次方间隔时间,比如:2、4、8、16 ...常见的错误返回码:
421 hl:icc 该ip同时并发连接数过大,超过了网易的限制,被临时禁止连接。451 requested mail action not taken: too much fail authentication 登录失败次数过多,被临时禁止登录。请检查密码与帐号验证设置553 authentication is required,密码配置不正确554 dt:spm 发送的邮件内容包含了未被许可的信息,或被系统识别为垃圾邮件。请检查是否有用户发送病毒或者垃圾邮件;550 invalid user 请求的用户不存在554 mi:stc 发件人当天内累计邮件数量超过限制,当天不再接受该发件人的投信。如果使用一个邮箱频繁发送相同内容邮件,也会被认定为垃圾邮件,报 554 dt:spm 错误
如果使用网易邮箱可以查看这里的提示:企业退信的常见问题?
6.4 异步发送
很多时候邮件发...