Playwright项目中Nodemailer无法发邮件且无报错的问题求助

核心排查与修复方向 #

1. 强制等待异步操作完成 #

Playwright 测试进程会在所有任务执行完毕后立即退出，如果邮件发送的异步操作未被 await，进程会直接终止，导致邮件根本没发出去。必须确保 onEnd 钩子为异步函数，并等待 sendMail 执行完成：

import nodemailer from 'nodemailer';

class CustomReporter {
  async onEnd() {
    const transporter = nodemailer.createTransport({
      // 你的SMTP配置
      host: 'smtp.xxx.com',
      port: 465,
      secure: true,
      auth: {
        user: 'your-email@xxx.com',
        pass: 'your-auth-code' // 注意：部分邮箱需用应用专用密码而非登录密码
      }
    });

    const mailOptions = {
      from: 'your-email@xxx.com',
      to: 'dev@xxx.com',
      subject: 'Playwright 测试报告',
      text: '测试已完成，详情见附件'
    };

    // 必须加try/catch捕获错误，同时await异步操作
    try {
      const info = await transporter.sendMail(mailOptions);
      console.log('邮件发送成功:', info.messageId);
    } catch (error) {
      console.error('邮件发送失败详情:', error);
    }
  }
}

export default CustomReporter;

2. 补全错误捕获逻辑 #

很多静默失败是因为错误被吞掉了，必须在邮件发送逻辑外层包裹完整的 try/catch，并打印详细错误信息（包括错误栈），不要依赖 Nodemailer 的默认处理。

3. 验证SMTP配置有效性 #

• 服务器地址与端口：确认对应邮箱的SMTP地址（如Gmail为smtp.gmail.com，Outlook为smtp.office365.com），端口通常SSL用465、TLS用587
• 授权方式：Gmail/Outlook等邮箱开启2FA后，必须使用应用专用密码而非登录密码；未开启2FA的需开启SMTP服务权限
• 网络限制：检查是否有防火墙/代理屏蔽了SMTP端口（比如公司内网常限制465/587端口）

4. 独立测试Nodemailer配置 #

先脱离Playwright环境，写一个单独的Node.js脚本测试邮件发送。如果脚本也失败，问题出在邮箱配置或网络；如果脚本成功，再回到Playwright reporter中排查钩子逻辑：

// test-mail.ts
import nodemailer from 'nodemailer';

async function testSendMail() {
  const transporter = nodemailer.createTransport({
    // 复制你的reporter中的SMTP配置
    host: 'smtp.xxx.com',
    port: 465,
    secure: true,
    auth: {
      user: 'your-email@xxx.com',
      pass: 'your-auth-code'
    }
  });

  try {
    const info = await transporter.sendMail({
      from: 'your-email@xxx.com',
      to: 'your-test-email@xxx.com',
      subject: '测试邮件',
      text: '这是一封测试邮件'
    });
    console.log('发送成功:', info.messageId);
  } catch (err) {
    console.error('发送失败:', err);
  }
}

testSendMail();

运行脚本：npx ts-node test-mail.ts，根据输出判断配置是否正确。

5. 确认Reporter钩子使用正确 #

确保邮件发送逻辑放在 onEnd 钩子中，这个钩子是Playwright所有测试执行完毕后才触发的唯一钩子，其他钩子（如onTestEnd）可能在进程结束前提前执行，导致异步操作被中断。

内容的提问来源于stack exchange，提问作者Aylin Naebzadeh