Node.js中使用Nodemailer发送电子邮件的完整指南

Nodemailer简介与安装

Nodemailer是Node.js生态中一款轻量且易于使用的邮件发送模块，下文将逐步演示其具体使用方法。

首先，需要通过npm安装该依赖库。

npm install nodemailer --save

核心功能特性

其次，了解该库的核心特性有助于更好地进行配置。

Nodemailer具备以下主要功能特性：

• 原生支持Unicode字符编码。
• 完全兼容Windows操作系统环境。
• 允许发送包含HTML格式或纯文本的内容。
• 支持附件传输，包括处理较大的附件文件。
• 支持在HTML邮件内容中嵌入图片资源。
• 提供SSL或STARTTLS协议支持，确保邮件传输过程的安全加密。
• 内置transport方法，同时也支持通过其他插件实现的transport机制。
• 允许开发者自定义插件以处理特定的消息逻辑。
• 集成XOAUTH2登录验证机制，增强认证安全性。

上述功能已能覆盖绝大多数邮件发送场景，接下来我们将通过代码实例进行实际操作。

基础代码示例

本节展示一个基础示例，演示如何发送包含明文和HTML正文的电子邮件。

这是一个完整的代码示例，用于发送包含纯文本和HTML内容的电子邮件。

var nodemailer = require('nodemailer');

// create reusable transporter object using the default SMTP transport
var transporter = nodemailer.createTransport('smtps://user%40gmail.com:pass@smtp.gmail.com');

// setup e-mail data with unicode symbols
var mailOptions = {
  from: 'Fred Foo 👥 <foo@blurdybloop.com>', // sender address
  to: 'bar@blurdybloop.com, baz@blurdybloop.com', // list of receivers
  subject: 'Hello ✔', // Subject line
  text: 'Hello world 🐴', // plaintext body
  html: '<b>Hello world 🐴</b>' // html body
};

// send mail with defined transport object
transporter.sendMail(mailOptions, function(error, info){
  if(error){
    return console.log(error);
  }
  console.log('Message sent: ' + info.response);
});

常见错误排查

以下是开发过程中可能遇到的常见错误及其原因分析。

{ [AuthError: Invalid login - 454 Authentication failed, please open smtp flag first!]
 name: 'AuthError',
 data: '454 Authentication failed, please open smtp flag first!',
 stage: 'auth' }

错误原因：邮箱账号未开启相关SMTP服务。 解决方案：登录QQ邮箱，进入设置 -> 帐户 -> 开启POP3/SMTP服务。

{ [SenderError: Mail from command failed - 501 mail from address must be same as authorization user]
 name: 'SenderError',
 data: '501 mail from address must be same as authorization user',
 stage: 'mail' }

错误原因：发件人账号与认证账号不一致，即用户名和密码匹配失败。

以上内容涵盖了Nodemailer的基本使用与常见问题处理，希望对各位开发者有所帮助。