如何用Nodemailer发邮件？本地集成后无法发送求原因

以下是针对你代码的常见问题排查点：

• OAuth2配置项验证

  • 先确认环境变量是否正确加载：在创建transporter前，打印process.env里的相关字段（比如console.log(process.env.OAUTH_CLIENTID)），看是否存在有效值。如果是本地开发，要确保已安装并配置dotenv加载.env文件。
  • 检查refreshToken有效性：Gmail的refreshToken会因权限变更、长期未使用失效，需重新生成。生成时必须勾选包含https://mail.google.com/或https://www.googleapis.com/auth/gmail.send的权限范围。
  • 核对Client ID/Secret：确保是从Google Cloud Console的「OAuth 2.0客户端ID」中复制的，而非服务账号密钥或其他类型凭证。

• Gmail账号与项目权限

  • 确认Google Cloud项目已启用Gmail API：进入Google Cloud Console的API库，搜索并启用Gmail API，否则会因权限不足拒绝请求。
  • 若使用个人Gmail账号，需确保账号已开启2FA（两步验证），并确认OAuth2流程是通过授权码正确获取的refreshToken；若未开启2FA，无法使用OAuth2发送邮件，需改用App Password（需开启2FA后生成）。
  • 检查Google账号安全状态：若近期有异常登录或发送行为触发安全机制，会被限制发送，可登录Google账号安全中心查看并解除限制。

• 代码逻辑缺失

  • 你只提供了创建transporter的代码，需确认是否调用了sendMail方法，完整发送逻辑示例：

    const mailOptions = {
      from: process.env.MAIL_USERNAME,
      to: '目标邮箱@xxx.com',
      subject: '测试邮件',
      text: '这是Nodemailer发送的测试内容'
    };
    
    transporter.sendMail(mailOptions, (error, info) => {
      if (error) {
        console.error('发送失败:', error); // 关键：打印错误信息定位问题
      } else {
        console.log('发送成功:', info.response);
      }
    });
    

  • 必须捕获并打印错误信息，Nodemailer的错误提示会直接指明问题根源（如权限错误、配置错误等）。

• 本地网络问题

  • 检查本地代理、防火墙是否拦截了SMTP连接：Gmail SMTP服务器地址为smtp.gmail.com，端口为465（SSL）或587（TLS），可通过telnet smtp.gmail.com 465测试连接是否畅通。

内容的提问来源于stack exchange，提问作者Anatoli Morozov