Nodemailer使用教程：在Node.js中发送电子邮件

1. 简介

2. 安装

3. 基本配置

3.1 创建传输器

3.2 配置说明

4. 发送邮件

4.1 基本发送示例

4.2 发送验证码示例

5. 常见问题解决

5.1 "Greeting never received" 错误

5.2 安全建议

SMTP与邮件加密协议详解

1. SMTP简介

1.1 基本特点

2. 加密协议对比

2.1 SSL/TLS (端口465)

2.2 STARTTLS (端口587)

3. 端口使用建议

3.1 常用端口对比

3.2 选择建议

4. 安全性考虑

4.1 SSL/TLS (465端口)优势

4.2 STARTTLS (587端口)注意事项

5. 常见邮件服务商配置

5.1 Gmail

5.2 Outlook/Office365

5.3 QQ邮箱

1. 简介

Nodemailer是Node.js平台上最流行的电子邮件发送库，它提供了一个简单而强大的解决方案，支持Unicode内容、HTML内容、附件、图片嵌入等功能。

2. 安装

首先需要安装Nodemailer包：

npm install nodemailer

3. 基本配置

3.1 创建传输器

首先需要创建一个传输器(transporter)，这是发送邮件的核心配置：

const nodemailer = require("nodemailer");const transporter = nodemailer.createTransport({host: "smtp.example.com",     // SMTP服务器地址port: 465,                    // SMTP端口secure: true,                 // 使用SSL/TLSauth: {user: "your-email@example.com",  // 邮箱账号pass: "your-password"            // 邮箱密码或应用专用密码}
});

3.2 配置说明

host: SMTP服务器地址

port: 常用端口

465 (SSL/TLS)
587 (STARTTLS)

secure:

true: 使用465端口
false: 使用其他端口

auth: 认证信息

4. 发送邮件

4.1 基本发送示例

async function sendEmail(to, subject, content) {const mailOptions = {from: '"发送者名称" <sender@example.com>',  // 发件人to: to,                                     // 收件人subject: subject,                           // 主题text: content,                             // 纯文本内容html: `<b>${content}</b>`                  // HTML内容};try {const info = await transporter.sendMail(mailOptions);console.log("邮件发送成功:", info.messageId);return info;} catch (error) {console.error("邮件发送失败:", error);throw error;}
}

4.2 发送验证码示例

以下是一个完整的发送验证码的实现：

const nodemailer = require("nodemailer");const transporter = nodemailer.createTransport({host: MAIL_HOST,    port: MAIL_PORT,    secure: true,       auth: {user: MAIL_USER,  pass: MAIL_PWD,   }
});const sendMail = async (to, subject, html) => {const mailOptions = {from: MAIL_USER,  // 发送者to,              // 接收者subject,         // 主题html,           // HTML内容};return await transporter.sendMail(mailOptions);
};

在控制器中使用：

async sendEmailCode(ctx, next) {const { email } = ctx.request.body;// 生成6位随机验证码const code = Math.random().toString().slice(2, 8);// 构建HTML模板const html = `<p>你好！</p><p>您正在注册社区账号</p><p>你的验证码是：<strong style="color: #ff4e2a;">${code}</strong></p><p>***该验证码5分钟内有效***</p>`;try {// 发送邮件await sendMail(email, "验证码", html);// 存储验证码（使用Redis）const emailCodeKey = `email:${email}`;await Redis.set(emailCodeKey, code, 60 * 5);ctx.body = {code: 0,message: "发送邮箱验证码成功",result: ""};} catch (error) {ctx.body = {code: -1,message: "发送邮箱验证码失败",error: error.message};}
}

5. 常见问题解决

5.1 "Greeting never received" 错误

如果遇到"Greeting never received"错误，通常有以下解决方案：

检查端口配置：

{port: 465,  // SSLsecure: true
}
// 或
{port: 587,  // STARTTLSsecure: false
}

检查网络连接

确认服务器设置是否正确

4. 验证认证信息是否正确