nodejs：用 nodemailer 发送一封带有附件的邮件

belldeep

已于 2025-06-07 19:24:57 修改

阅读量639

点赞数 8

CC 4.0 BY-SA版权

分类专栏： nodejs javascript 文章标签： nodejs nodemailer send email

于 2025-06-07 15:15:57 首次发布

本文链接：https://blog.csdn.net/belldeep/article/details/148495806

javascript 同时被 2 个专栏收录

42 篇文章

订阅专栏

nodejs

16 篇文章

订阅专栏

我们将使用 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,            // 使用SSL
  auth: {
    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官方文档