前言
平时工作中很少用到需要发邮件的功能,所以邮件这块的功能也没有太过关注。近期有一个项目需要接收用户的反馈,上边决定使用邮件,直接将反馈信息发送给领导,也就有了这篇文章。实现发邮件不难,但是开发中遇到了一个问题,就是本地测试都是好好的,结果部署到阿里云服务器后,邮件总是发送失败,经过一番的折腾终于找到了问题,特此记录。
一、安装需要的类库
我这边使用的 .Net Core 3.1进行的开发,经过查找最终决定使用 MailKit,这里最终选择了 NETCore.MailKit ,不为别的,时间紧任务重,这个实现起来最方便。
Install-Package NETCore.MailKit -Version 2.0.3
二、配置
配置 appsetting.json
以下示例使用的网易的163邮箱,在appsetting.json 中添加以下配置
"EmailOptions": {"SenderName": "系统邮件", //发送者名称,可在代码中重新替换"FromAddress": "", //发件者邮箱"ToAddress": "", //接收人邮箱"Host": "smtp.163.com", //主机"Port": 25, //端口 阿里云默认25端口不开放,需要使用SSL的465端口"UserName": "", //发件邮箱账号"Password": "" //发件邮箱密码}
添加 EmailOptions
针对上边的配置,创建对应的类来实现配置文件绑定。
public class EmailOptions{public string FromAddress { get; set; }public string ToAddress { get; set; }public string Host { get; set; }public string UserName { get; set; }public string Password { get; set; }}
配置 Startup
在 Startup的ConfigureServices方法中添加以下配置
//发邮件services.Configure<EmailOptions>(Configuration.GetSection("EmailOptions"));services.AddMailKit(optionBuilder =>{optionBuilder.UseMailKit(new MailKitOptions(){//get options from sercets.jsonServer = Configuration.GetValue<string>("EmailOptions:Host"),Port = Configuration.GetValue<int>("EmailOptions:Port"),SenderName = Configuration.GetValue<string>("EmailOptions:SenderName"),SenderEmail = Configuration.GetValue<string>("EmailOptions:FromAddress"),// can be optional with no authentication Account = Configuration.GetValue<string>("EmailOptions:UserName"),Password = Configuration.GetValue<string>("EmailOptions:Password"),// enable ssl or tlsSecurity = true});});
三、发送邮件
将配置EmailOptions和 IEmailService 注入到需要使用的位置。如:
public class HomeController : Controller{private readonly EmailOptions options;private readonly IEmailService _EmailService;public HomeController(IOptions<EmailOptions> options, IEmailService emailService){this.options = options.Value;_EmailService = emailService;}[HttpPost]public async Task<ActionResult> SendEmail(MyEntity entity){//设置发送人的邮件地址和名称,在接收人接收到邮件提示时会显示该信息var sendInfo = new SenderInfo{SenderEmail = options.FromAddress,SenderName = "投诉",};await _EmailService.SendAsync(options.ToAddress, "投诉", "邮件内容", false, sender: sendInfo);return Json(result);}}
遇到的问题
本地开发时使用的端口是25,本地测的好好的,但是当部署到阿里云的时候,只要一执行发邮件的方法,就会超时,百思不得其解,后来得知阿里云服务器默认是禁止25端口的,解决方法就是改成465端口发送邮件。