我们将使用 nodemailer 库来发送带有附件的邮件。
首先,确保已经安装了nodemailer。如果没有安装,可以通过
npm install nodemailer 来安装。
cnpm install nodemailer --save
dependencies:
– nodemailer ^7.0.3
步骤:
- 引入nodemailer模块。
- 创建传输器(transporter)对象,用于发送邮件。需要配置SMTP服务(这里以QQ邮箱为例,也可以使用其他服务)。
- 设置邮件选项(mailOptions),包括发件人、收件人、主题、正文以及附件。
- 使用 transporter.sendMail 方法发送邮件,并处理回调。
注意:使用QQ邮箱 SMTP 服务需要开启 POP3/SMTP服务,并生成授权码(不是邮箱密码)。
以下是一个使用 Node.js 发送带附件邮件的完整示例,使用 nodemailer
库实现:
// send_email_1.js 发送一封带有附件的邮件
const nodemailer = require('nodemailer');
const path = require('path');// 创建 SMTP 传输器(以QQ邮箱为例,其他邮箱配置类似)
const transporter = nodemailer.createTransport({host: 'smtp.qq.com', // QQ邮箱SMTP服务器port: 465, // SSL端口secure: true, // 使用SSLauth: {user: 'your_email@qq.com', // 替换为你的邮箱pass: 'your_auth_code' // 替换为邮箱授权码(不是密码)}
});// 邮件配置
const mailOptions = {from: '"发件人名称" <your_email@qq.com>', // 发件人to: 'recipient@example.com', // 收件人subject: '带附件的测试邮件', // 邮件主题text: '这是一封包含附件的测试邮件', // 纯文本正文html: '<b>这是一封包含附件的测试邮件</b>', // HTML正文attachments: [ // 附件列表{filename: 'document.pdf', // 附件显示名称path: path.join(__dirname, 'files/document.pdf') // 附件路径},{filename: 'image.png',path: path.join(__dirname, 'files/image.png'),cid: 'unique-image-id' // 用于在HTML中嵌入图片}]
};// 发送邮件
transporter.sendMail(mailOptions, (error, info) => {if (error) {return console.log('发送失败:', error);}console.log('邮件已发送: %s', info.messageId);
});
使用说明:
-
安装依赖:
npm install nodemailer
-
邮箱配置:
- 使用 QQ 邮箱需要开启 SMTP 服务并获取授权码(登录QQ邮箱 → 设置 → 账户 → 开启POP3/SMTP → 生成授权码)
- 其他邮箱(Gmail、163等)配置参考:
// Gmail 示例 host: 'smtp.gmail.com', port: 465, secure: true, auth: {user: 'your@gmail.com',pass: 'your-app-password' // 需使用Google应用专用密码 }
-
附件配置:
filename
:收件人看到的文件名path
:本地文件路径(绝对路径推荐)cid
:用于在HTML内容中引用图片(如<img src="cid:unique-image-id">
)
-
运行程序:
node send_email_1.js
常见问题解决:
-
认证失败:
- 确认邮箱服务已开启SMTP
- 使用授权码而非邮箱密码
- Gmail需要开启两步验证并创建应用专用密码
-
附件大小限制:
- 大多数邮箱服务商限制附件大小(QQ邮箱≤50MB)
- 超大附件建议使用云存储链接
-
安全警告:
- 首次登录可能触发安全警告,需在邮箱中确认
- Gmail需开启"低安全性应用访问"(不推荐)或使用OAuth2
进阶使用(HTML内容嵌入图片):
<html><body><p>这是一封带图片附件的邮件:</p><!-- 使用 cid 引用附件图片 --><img src="cid:unique-image-id" alt="嵌入图片"></body>
</html>
提示:生产环境建议将邮箱配置存储在环境变量中(使用
dotenv
库),避免敏感信息泄露。
完整文档参考:nodemailer官方文档