Node.js发送邮件教程详解

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Node.js如何发送邮件？》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

使用Nodemailer是Node.js发送邮件最稳妥的方法，它封装了SMTP协议的复杂性，提供简洁API。首先安装并配置传输器，包含SMTP服务器地址、端口、加密方式及认证信息，建议将密码等敏感信息存于环境变量以保障安全。接着定义邮件内容，包括发件人、收件人、主题、文本和HTML内容，还可添加附件或内联图片。通过transporter.sendMail()发送邮件，并用try-catch处理异常，确保可靠性。生产环境中应避免使用个人邮箱，推荐集成SendGrid、Mailgun等专业服务以提升送达率。对于动态邮件，可结合EJS等模板引擎渲染个性化内容，实现高效、安全、可维护的邮件系统。

在Node.js中发送邮件，最直接、最常见且我个人觉得最稳妥的方法，就是借助一个成熟的第三方库——Nodemailer。它几乎已经成了Node.js邮件发送的事实标准，因为它功能强大、配置灵活，并且社区支持也非常好。简单来说，就是通过这个库，我们可以连接到邮件服务提供商的SMTP服务器，然后把我们的邮件内容“投递”过去。

解决方案

使用Nodemailer发送邮件的核心步骤其实就那么几步，说实话，掌握了这些，大部分邮件发送场景都能应对了。

首先，当然是安装Nodemailer：

npm install nodemailer

接着，在你的Node.js代码里，你需要配置一个“传输器”（transporter），它负责连接到你的邮件服务提供商。这里我以一个常见的SMTP服务为例，比如你公司的SMTP服务器，或者一些公共服务如Gmail（虽然生产环境不推荐直接用个人Gmail账号，但作为示例很直观）。

const nodemailer = require('nodemailer');

async function sendEmail() {
    // 1. 创建一个传输器对象
    // 这里你需要替换成你自己的SMTP服务配置
    // 比如：host, port, secure (是否使用TLS/SSL), auth (用户名和密码)
    let transporter = nodemailer.createTransport({
        host: 'smtp.example.com', // 你的SMTP服务器地址
        port: 587, // 通常是587（StartTLS）或465（SSL）
        secure: false, // true表示使用SSL（端口465），false表示使用StartTLS（端口587）
        auth: {
            user: 'your_email@example.com', // 你的邮箱地址
            pass: 'your_email_password' // 你的邮箱密码或应用专用密码
        },
        // 如果你的SMTP服务器证书有问题，可以加上这行，但生产环境不推荐
        // tls: {
        //     rejectUnauthorized: false
        // }
    });

    // 2. 定义邮件内容
    let mailOptions = {
        from: '"发件人名称" <your_email@example.com>', // 发件人地址
        to: 'recipient@example.com, another@example.com', // 收件人列表，多个用逗号分隔
        subject: '这是一封来自Node.js的测试邮件 ✔', // 邮件主题
        text: 'Hello world? 这是一封纯文本邮件内容！', // 纯文本内容
        html: '<b>Hello world?</b> 这是一封<i>HTML</i>邮件内容！' // HTML内容
    };

    // 3. 发送邮件
    try {
        let info = await transporter.sendMail(mailOptions);
        console.log('邮件发送成功:', info.messageId);
        // info.envelope 包含发件人和收件人
        // info.accepted 包含接受邮件的收件人
        // info.rejected 包含拒绝邮件的收件人
    } catch (error) {
        console.error('邮件发送失败:', error);
    }
}

sendEmail();

需要注意的是，auth.pass 里的密码，在生产环境中绝不应该直接写在代码里。我通常会把它放在环境变量里，然后通过 process.env.EMAIL_PASS 来获取。这不仅是安全最佳实践，也能避免代码部署时的不便。

为什么不直接用Node.js内置功能发邮件？

这是一个很好的问题，尤其对于刚接触Node.js的开发者来说，可能会觉得既然Node.js能处理网络请求，为什么不能直接发邮件呢？说实话，Node.js本身是一个运行时环境，它提供了很多底层能力，比如TCP/IP通信，但它并没有直接内置发送邮件这种高级应用层的协议支持。邮件发送依赖的是SMTP（Simple Mail Transfer Protocol）协议，这个协议本身就有一套复杂的握手、认证和数据传输流程。

如果我们要从零开始实现SMTP客户端，那将是一个相当大的工程。我们需要处理：

• TCP连接管理： 建立、维护和关闭连接。
• 协议握手： 发送HELO/EHLO命令，协商支持的功能。
• 认证机制： 处理PLAIN、LOGIN、CRAM-MD5等多种认证方式。
• MIME类型处理： 邮件内容通常是多部分的，包含文本、HTML、附件等，需要正确编码。
• 错误处理与重试： 网络不稳定、服务器拒绝等情况都需要妥善处理。
• 安全性： TLS/SSL加密，确保邮件内容不被窃听。

Nodemailer这样的库，就是把所有这些繁琐的细节都封装好了，提供一个简洁的API给我们使用。它不仅仅是帮你发个请求，更是一个完整的SMTP客户端实现，帮你处理了协议栈、编码、错误处理等一系列问题。我个人觉得，除非你真的想深入研究SMTP协议，否则直接用Nodemailer，既高效又可靠，还能享受到社区持续的维护和更新，何乐而不为呢？

如何确保邮件发送的安全性与可靠性？

邮件发送的安全性与可靠性在生产环境中至关重要，这不仅仅是邮件能发出去那么简单，更要考虑邮件能否安全抵达、不被拦截，以及系统在高负载下的稳定性。

首先，认证信息绝不能硬编码。前面提到了，将邮箱账号和密码（或应用专用密码）存储在环境变量中，是最低限度的安全要求。更进一步，对于一些大型邮件服务商，比如Gmail、Outlook，它们可能支持OAuth2认证，这比传统的用户名密码更安全，因为它避免了直接暴露你的密码。Nodemailer也支持OAuth2，配置起来会稍微复杂一点，但安全性提升是值得的。

其次，始终使用加密连接。Nodemailer默认在端口465时会启用SSL，在端口587时会使用StartTLS。确保你的secure配置正确，并且你的SMTP服务支持这些加密方式。加密可以防止邮件内容在传输过程中被窃听或篡改。如果你连接的SMTP服务器证书有问题，Nodemailer可能会报错，虽然可以通过tls: { rejectUnauthorized: false }来跳过验证，但这在生产环境是极不推荐的，因为它会大大降低安全性，形同虚设。

再者，错误处理和日志记录是可靠性的基石。邮件发送是一个外部依赖操作，网络问题、SMTP服务器拒绝、认证失败等都可能导致发送失败。你的代码需要有健壮的try-catch块来捕获transporter.sendMail()可能抛出的异常，并将这些错误详细记录下来。这样，当邮件发送失败时，你才能及时发现问题并进行排查。

最后，考虑使用专业的邮件服务提供商。对于需要大量发送邮件的场景（比如营销邮件、通知邮件），我强烈建议使用SendGrid、Mailgun、AWS SES、Postmark等专业的事务性邮件服务。它们不仅提供高可用性、高送达率，还能处理IP信誉、反垃圾邮件、邮件追踪（是否打开、是否点击链接）等复杂问题。直接使用个人邮箱（如Gmail）进行大量发送，很可能会触发反垃圾邮件机制，导致邮件被拒收或进入垃圾箱，甚至你的账号可能会被暂时锁定。这些专业服务通常有更好的API和SDK，集成起来也更方便，并且提供了详尽的发送日志和分析报告，这对于监控邮件系统的健康状况非常有帮助。

发送带附件、HTML内容或模板邮件有哪些技巧？

在实际应用中，纯文本邮件很少见，我们通常需要发送更丰富的内容，比如带有格式的HTML邮件、包含图片或文档的附件，甚至是基于模板动态生成的邮件。Nodemailer在这些方面提供了非常灵活的支持。

发送HTML内容：

这其实很简单，你只需要在mailOptions对象中，将你的HTML字符串赋值给html属性即可。如果同时提供了text和html，大多数邮件客户端会优先显示html内容，而text则作为备用或在不支持HTML的客户端中显示。

let mailOptions = {
    // ...其他配置
    subject: '这是一封带HTML内容的邮件',
    text: '如果客户端不支持HTML，会显示这行纯文本。',
    html: `
        <h1>欢迎来到我们的服务！</h1>
        <p>这是您的<b>账户激活链接</b>：<a href="https://example.com/activate">点击这里</a></p>
        <img src="cid:unique@example.com" alt="Logo">
        <p>谢谢！</p>
    `
};

发送带附件的邮件：

mailOptions对象有一个attachments属性，它是一个数组，每个元素代表一个附件。附件可以是一个文件路径、一个Buffer，或者一个URL。

let mailOptions = {
    // ...其他配置
    subject: '这是一封带附件的邮件',
    text: '请查收附件。',
    attachments: [
        {
            filename: 'document.pdf', // 附件在邮件中的显示名称
            path: '/path/to/your/document.pdf', // 本地文件路径
            contentType: 'application/pdf' // 可选，Nodemailer通常能自动识别
        },
        {
            filename: 'report.txt',
            content: '这是附件的文本内容。', // 直接提供内容
            contentType: 'text/plain'
        },
        {
            filename: 'image.png',
            path: 'https://example.com/images/logo.png', // 从URL获取附件
            cid: 'unique@example.com' // 用于HTML邮件中内联图片
        }
    ]
};

特别提一下cid，当你在HTML内容中需要嵌入图片，而不是作为单独的附件时，可以使用cid:（Content ID）引用。在attachments中给图片设置一个cid，然后在HTML的标签中，src属性就指向cid:后面跟着的ID。这样图片就会随着邮件内容一起显示，而不是作为单独的附件出现在附件列表中。

发送模板邮件：

对于需要发送大量格式相似但内容动态变化的邮件（比如注册确认、密码重置、订单通知），使用模板引擎是最佳实践。常见的Node.js模板引擎有EJS、Handlebars、Pug等。

基本思路是：

1. 选择一个模板引擎，并安装它。
2. 创建你的邮件模板文件（例如，welcome.ejs）。
3. 在Node.js代码中，加载并渲染这个模板，将动态数据传入，生成最终的HTML字符串。
4. 将生成的HTML字符串赋值给mailOptions.html属性。

以EJS为例：

const ejs = require('ejs');
const path = require('path');

async function sendTemplatedEmail(userData) {
    const templatePath = path.join(__dirname, 'templates', 'welcome.ejs');
    // 渲染模板，传入动态数据
    const htmlContent = await ejs.renderFile(templatePath, {
        userName: userData.name,
        activationLink: `https://example.com/activate/${userData.token}`
    });

    let mailOptions = {
        from: '"Your App" <noreply@example.com>',
        to: userData.email,
        subject: `欢迎 ${userData.name} 加入我们！`,
        html: htmlContent
    };

    // ... 使用transporter发送mailOptions
}

// 示例调用
// sendTemplatedEmail({ name: '张三', email: 'zhangsan@example.com', token: 'some_token' });

通过这种方式，你可以将邮件的结构和样式与数据逻辑分离，使得邮件内容的维护和更新变得更加容易，也更容易实现个性化定制。

文中关于Node.js,邮件的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Node.js发送邮件教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。