首页 > web前端 > js教程 > 正文

怎样使用Node.js发送邮件?

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

怎样使用node.js发送邮件?

在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,集成起来也更方便,并且提供了详尽的发送日志和分析报告,这对于监控邮件系统的健康状况非常有帮助。

工资查查移动工资条
工资查查移动工资条

大部分的工资还是以打印工资条的形式进行,偶有公司使用邮件发放工资条,而工资条的现代形式应该是移动工资条,以实现信息的备忘、到达、管理、对帐、环保、高效等需求……,用户已经习惯使用手机(或以其它移动方式)实现一切需求,应用的移动化是大势所趋。工资查查就在这样的背景下诞生,北京亦卓科技于2017的开发并推出了微信小程序工资查查。由于对有用户对数据隐私与安全性的考虑,北京亦卓科技在推出了云端应用--工资

工资查查移动工资条 0
查看详情 工资查查移动工资条

发送带附件、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的
<img>
登录后复制
标签中,
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发送邮件?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号