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

我们将使用 nodemailer 库来发送带有附件的邮件。

首先，确保已经安装了nodemailer。如果没有安装，可以通过
npm install nodemailer 来安装。
cnpm install nodemailer --save
dependencies:
– nodemailer ^7.0.3

步骤：

1. 引入nodemailer模块。
2. 创建传输器（transporter）对象，用于发送邮件。需要配置SMTP服务（这里以QQ邮箱为例，也可以使用其他服务）。
3. 设置邮件选项（mailOptions），包括发件人、收件人、主题、正文以及附件。
4. 使用 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);
});

使用说明：

1. 安装依赖：

   npm install nodemailer
   

2. 邮箱配置：

   • 使用 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应用专用密码
     }
     

3. 附件配置：

   • filename：收件人看到的文件名
   • path：本地文件路径（绝对路径推荐）
   • cid：用于在HTML内容中引用图片（如 <img src="cid:unique-image-id">）

4. 运行程序：

   node send_email_1.js
   

常见问题解决：

1. 认证失败：

   • 确认邮箱服务已开启SMTP
   • 使用授权码而非邮箱密码
   • Gmail需要开启两步验证并创建应用专用密码

2. 附件大小限制：

   • 大多数邮箱服务商限制附件大小（QQ邮箱≤50MB）
   • 超大附件建议使用云存储链接

3. 安全警告：

   • 首次登录可能触发安全警告，需在邮箱中确认
   • Gmail需开启"低安全性应用访问"（不推荐）或使用OAuth2

进阶使用（HTML内容嵌入图片）：

<html>
  <body>
    <p>这是一封带图片附件的邮件：</p>
    <!-- 使用 cid 引用附件图片 -->
    <img src="cid:unique-image-id" alt="嵌入图片">
  </body>
</html>

提示：生产环境建议将邮箱配置存储在环境变量中（使用 dotenv 库），避免敏感信息泄露。

完整文档参考：nodemailer官方文档