使用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: '"发件人名称" ', // 发件人地址
to: 'recipient@example.com, another@example.com', // 收件人列表，多个用逗号分隔
subject: '这是一封来自Node.js的测试邮件 ✔', // 邮件主题
text: 'Hello world? 这是一封纯文本邮件内容！', // 纯文本内容
html: 'Hello world? 这是一封HTML邮件内容！' // 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在这些方面提供了非常灵活的支持。
专为中小型企业定制的网络办公软件,富有竞争力的十大特性： 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装，建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件，使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件，提供web方式的远程邮件服务。 4、集成语音会议组件，节省长途话费开支。 5、集成手机短信组件，重要信息可直接发送到员工手机。 6、集成网络硬
发送HTML内容：
这其实很简单，你只需要在
mailOptions对象中，将你的HTML字符串赋值给
html属性即可。如果同时提供了
text和
html，大多数邮件客户端会优先显示
html内容，而
text则作为备用或在不支持HTML的客户端中显示。
let mailOptions = {
// ...其他配置
subject: '这是一封带HTML内容的邮件',
text: '如果客户端不支持HTML，会显示这行纯文本。',
html: `
欢迎来到我们的服务！
这是您的账户激活链接：点击这里
@@##@@
谢谢！
`
};发送带附件的邮件：
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等。
基本思路是：
- 选择一个模板引擎，并安装它。
- 创建你的邮件模板文件（例如，
welcome.ejs
）。 - 在Node.js代码中，加载并渲染这个模板，将动态数据传入，生成最终的HTML字符串。
- 将生成的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" ',
to: userData.email,
subject: `欢迎 ${userData.name} 加入我们！`,
html: htmlContent
};
// ... 使用transporter发送mailOptions
}
// 示例调用
// sendTemplatedEmail({ name: '张三', email: 'zhangsan@example.com', token: 'some_token' }); 通过这种方式，你可以将邮件的结构和样式与数据逻辑分离，使得邮件内容的维护和更新变得更加容易，也更容易实现个性化定制。
