自动化测试项目发送带附件邮件报告的方法

本文详细介绍如何使用 Node.js 的 Nodemailer 库，实现自动化测试报告（包括 HTML、JSON 或截图）通过邮件自动发送给相关人员，全面支持 Gmail、Outlook 等主流 SMTP 服务，并逐步说明配置步骤、安全凭证设置及附件添加方法。

自动化测试执行完毕，报告也已生成，但如何让团队成员第一时间获取测试结果？通过邮件发送带附件的报告是最直接的方式。这一需求在持续集成（CI）流程中几乎不可或缺——无论是基于 Selenium 的 Web UI 自动化测试，还是其他类型的自动化项目，测试报告的及时同步对于质量反馈闭环至关重要。

在 Node.js 生态中，Nodemailer 是一款成熟、轻量且广泛应用的邮件发送库，原生支持附件、HTML 内容、多收件人、抄送等特性，完全能够满足自动化测试报告（如 Allure 报告、JUnit XML、自定义 HTML 报告）的自动分发需求。接下来，我们将直接进入正题，详细介绍如何配置、发送邮件，以及安全地管理 SMTP 凭证。

✅ 快速入门：安装与基础配置

首先初始化项目，安装所需依赖，操作非常简单：

npm init -y
npm install nodemailer

✅ 安全配置 SMTP 凭据（以 Gmail 为例）

⚠️ 注意：切勿在代码中硬编码密码。Gmail 要求使用“应用专用密码（App Password）”或启用两步验证后的 OAuth2 令牌。推荐做法如下：

1. 开启 Google 账户的“两步验证”；
2. 进入 Google App Passwords 页面，生成一个 16 位应用专用密码；
3. 使用该密码填充 auth.pass 字段（而非账户登录密码）。

const nodemailer = require('nodemailer');
const fs = require('fs');

const transporter = nodemailer.createTransporter({
  service: 'gmail', // 或显式配置：host: 'smtp.gmail.com', port: 465, secure: true
  auth: {
    user: 'your-email@gmail.com',
    pass: 'your-app-specific-password' // ✅ 不是 Gmail 登录密码！
  }
});

✅ 发送带附件的测试报告（核心示例）

假设 Selenium 测试执行后生成了 report.html 和 screenshots.zip 文件，可以通过以下方式附加多个附件：

const reportPath = './reports/report.html';
const zipPath = './reports/screenshots.zip';

transporter.sendMail({
  from: '"Test Automation" ',
  to: 'stakeholder@company.com, qa-team@company.com',
  cc: 'manager@company.com',
  subject: `【自动化测试报告】${new Date().toLocaleDateString()}`,
  html: `
✅ 自动化测试已完成
         
执行环境：Chrome v124 | 总用例数：42 | 通过率：95.2%
         
详见附件报告。
`,
  attachments: [
    { filename: 'test-report.html', path: reportPath },
    { filename: 'screenshots.zip', path: zipPath },
    // ✅ 也可直接传 Buffer 或字符串内容（如 JSON 报告）
    { 
      filename: 'summary.json', 
      content: JSON.stringify({ passed: 40, failed: 2, duration: '2m18s' }, null, 2) 
    }
  ]
}).then(info => console.log('✅ 邮件已发送，Message ID:', info.messageId))
  .catch(err => console.error('❌ 邮件发送失败:', err));

? 其他安全与最佳实践建议

• 环境隔离：将邮箱配置存放在 .env 文件中（配合 dotenv 加载），避免提交到版本控制系统；
• 错误重试机制：生产环境建议封装 sendMail() 并加入指数退避重试逻辑；
• 大附件处理：单封邮件附件总大小建议不超过 25MB；超限可改用云存储（如 AWS S3/Google Drive）生成临时下载链接嵌入邮件；
• 替代服务选项：若企业禁用 Gmail，Nodemailer 同样兼容 Outlook (service: 'hotmail')、腾讯企业邮、阿里云邮件推送等，只需调整 host/port/auth 参数。

✅ 总结与建议

Nodemailer 不仅解决了“发送带附件邮件”这一核心需求，更因其稳定性和完善的文档，成为 CI/CD 流水线（如 GitHub Actions、Jenkins）中集成邮件通知的事实标准。通过配合 Selenium 测试脚本的 afterAll 或 onFinish 钩子，即可实现“测试执行完成 → 报告生成 → 自动归档 → 邮件通知”的完整闭环。最后再次强调：安全凭证管理比功能实现更为重要——始终优先使用应用专用密码或 OAuth2，而非账户主密码。