如何处理Refresh Token过期？自动化方案及邮件服务选型建议

一、为什么你的Refresh Token会过期？ #

• 你通过OAuth Playground生成的Refresh Token属于临时Token，Google对处于「测试状态」的OAuth应用，Refresh Token默认7天过期。
• 你的配置中使用了https://developers.google.com/oauthplayground作为redirect_uri，这种方式获取的Token不具备长期有效性。

二、获取长期有效Refresh Token的正确步骤 #

1. 在Google Cloud后台配置你的OAuth客户端：
   • 将redirect_uri设置为你自己的后端回调地址（比如开发环境用http://localhost:3000/auth/google/callback）
   • 在OAuth consent screen中，将应用状态从「Testing」切换为「In production」（即使是个人项目，完成基础信息提交即可）
2. 实现标准OAuth授权流程：
   • 构造授权URL时必须包含access_type=offline和prompt=consent参数，确保获取到长期有效的Refresh Token
   • 让邮箱账号所有者完成一次授权，将返回的授权码兑换为Refresh Token，保存到.env文件中

三、优化你的Nodemailer代码 #

无需手动管理access token，google-auth-library会自动处理刷新逻辑，简化后的代码如下：

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

const oAuth2Client = new google.auth.OAuth2(
  process.env.CLIENT_ID,
  process.env.CLIENT_SECRET,
  process.env.REDIRECT_URI // 替换为你自己的回调地址
);

oAuth2Client.setCredentials({ refresh_token: process.env.REFRESH_TOKEN });

const createTransporter = async () => {
  const transporter = nodemailer.createTransport({
    service: "gmail",
    auth: {
      type: "OAuth2",
      user: "rockthebarrio@gmail.com",
      clientId: process.env.CLIENT_ID,
      clientSecret: process.env.CLIENT_SECRET,
      refreshToken: process.env.REFRESH_TOKEN,
      // 自动获取并刷新access token
      accessToken: await oAuth2Client.getAccessToken().then(res => res.token)
    },
  });

  // 或者更简洁的方式，直接传递oauth2客户端实例
  // const transporter = nodemailer.createTransport({
  //   service: "gmail",
  //   auth: {
  //     type: "OAuth2",
  //     user: "rockthebarrio@gmail.com",
  //     oauth2: oAuth2Client
  //   }
  // });

  return transporter;
};

四、更易操作的替代邮件服务 #

如果觉得Gmail OAuth流程过于繁琐，推荐以下专为应用邮件设计的服务：

• SendGrid：免费额度满足个人项目需求，支持API和SMTP两种发送方式，只需配置API Key即可，无需OAuth
• Mailgun：提供完善的邮件统计和日志功能，配置简单，免费版可满足基础发送需求
• Postmark：以高送达率著称，适合对邮件可靠性要求高的场景，配置直观

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