Node.js集成Google OAuth2.0发送Gmail邮件无报错无输出问题

架构老林

2026-8-30

问题诊断

代码无报错也不执行发信逻辑，是存在以下核心错误：

OAuth权限范围配置错误：当前填写的是Google Drive只读权限，未申请Gmail发信必需的SMTP权限，即使授权成功也不具备发信资格
本地HTTP服务仅创建实例未调用listen()启动，服务未运行自然无法处理授权回调、触发后续发信逻辑，引入的opn、server-destroy依赖完全未被使用
变量名大小写拼写错误：定义的OAuth客户端实例名为oauth2Client（首字母小写o），后续取token信息时写成oAuth2Client（大写A），运行到该行会触发未定义变量错误，且错误被逻辑吞掉无感知
发信token取值错误：getTokenInfo()返回结果中不包含refreshToken和accessToken，两个有效值存在之前获取的tokens对象中，传参错误会导致nodemailer无法连接SMTP服务
邮件模板语法错误：用单引号包裹HTML字符串时，内部的${name}、验证链接变量不会被解析，a标签href直接写{url}也无法替换为真实验证地址
sendMail回调逻辑错误：回调内的return仅在回调函数作用域生效，既不会向外层返回结果，也未做错误捕获，发信失败也看不到报错
逻辑冗余：环境变量已经存储了刷新令牌，不需要每次调用发信函数都启动本地服务走一遍OAuth授权流程，该逻辑仅在首次获取刷新令牌时需要做一次，拿到令牌后持久化存储即可，无需每次重复触发

修复方案

将OAuth权限范围替换为Gmail发信所需权限
删除冗余的本地临时HTTP服务逻辑，直接用环境变量中存储的客户端ID、密钥、刷新令牌初始化OAuth客户端，自动续期有效的访问令牌
修正所有变量名拼写错误，HTML模板改用反引号包裹，正确插值动态变量
将发信逻辑改为Promise写法，正确捕获错误、返回发信结果
调整函数入参名，避免和Node内置url模块重名引发异常

修正后可运行代码

const dotenv = require("dotenv");
const nodemailer = require("nodemailer");
const { google } = require("googleapis");

dotenv.config();

const { EMAIL, MAILING_ID, MAILING_REFRESH, MAILING_SECRET } = process.env;
const OAuth2 = google.auth.OAuth2;

exports.sendVerificationEmail = async (email, name, verifyUrl) => {
  console.log("开始发送验证邮件");

  // 初始化OAuth客户端
  const oauth2Client = new OAuth2(
    MAILING_ID,
    MAILING_SECRET,
    "https://developers.google.com/oauthplayground"
  );

  // 配置已持久化存储的刷新令牌
  oauth2Client.setCredentials({
    refresh_token: MAILING_REFRESH
  });

  // 自动获取当前有效的访问令牌
  const accessToken = await oauth2Client.getAccessToken();

  // 初始化SMTP传输实例
  const smtpTransport = nodemailer.createTransport({
    service: "gmail",
    auth: {
      type: "OAuth2",
      user: EMAIL,
      clientId: MAILING_ID,
      clientSecret: MAILING_SECRET,
      refreshToken: MAILING_REFRESH,
      accessToken: accessToken.token
    }
  });

  // 邮件配置
  const mailOptions = {
    from: EMAIL,
    to: email,
    subject: "账号注册验证",
    html: `<div><div style="max-width:500px;margin-bottom:1rem;align-items:center;display:flex"><img style="width:40px" src="https://seeklogo.com/images/F/facebook-icon-circle-logo-09F32F61FF-seeklogo.com.png" alt=""><span style="font-family:sans-serif;color:#3266a8;font-weight:700;padding-left:10px">操作提醒：请激活你的账号</span></div><div style="border-top:1px solid;border-bottom:1px solid;border-color:#deb887;padding:10px;padding-bottom:20px"><div style="height:35px"><span style="font-weight:700;font-family:sans-serif">你好 ${name}</span></div><div style="height:28px;font-family:sans-serif;padding-bottom:20px"><span>你近期在我们的平台创建了账号，请点击下方按钮完成验证</span></div><div style=""><a href="${verifyUrl}" style="background-color:#3266a8;color:#fff;border-radius:10px;font-weight:700;font-family:sans-serif;text-decoration:none;font-size:15px;text-align:center;padding:9px;margin-bottom:1.5em">确认账号</a></div></div></div>`
  };

  // 执行发信
  try {
    const sendResult = await smtpTransport.sendMail(mailOptions);
    console.log("邮件发送成功", sendResult);
    return sendResult;
  } catch (err) {
    console.error("邮件发送失败", err);
    throw err;
  }
};

注意事项

确保环境变量中存储的MAILING_REFRESH是对应Gmail发信权限申请的刷新令牌，若之前申请时选错了权限范围，需要重新生成刷新令牌替换
确保发信使用的Gmail账号状态正常，已开启两步验证，无收发信限制

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