nodejs：用 nodemailer 发送一封带有附件的邮件
我们将使用 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官方文档