Node.js实现忘记密码功能时POST报500，提示"PLAIN"认证凭证缺失

错误原因 #

• XOAuth2配置参数缺失
  你当前使用xoauth2.createXOAuth2Generator时仅传入了user和clientSecret两个参数，谷歌OAuth2认证要求必填的clientId、refreshToken参数缺失，导致无法生成有效的认证凭证，nodemailer自动降级到PLAIN认证模式，但你没有提供PLAIN模式需要的用户名+密码配置，因此触发Missing Credentials for "PLAIN"错误。
• 认证模式冲突
  你同时开启了邮箱低安全性应用访问权限、使用OAuth2认证逻辑，二者是互斥的配置：低安全性应用对应PLAIN密码认证模式，OAuth2是独立的第三方认证模式，混用配置导致逻辑混乱。
• .env文件未正确加载
  如果代码开头没有引入dotenv库并执行初始化，process.env下的自定义变量会全部为undefined，相当于没有传入任何凭证，也会触发该错误。
• TLS配置过时
  你配置的SSLv3加密套件早已被Gmail废弃，当前Gmail SMTP要求使用TLSv1.2及以上版本的加密协议，错误的TLS配置会导致连接失败，间接触发认证错误。

修复方案 #

方案1：使用PLAIN密码认证（适配已开启低安全性应用的场景） #

直接删除xoauth2相关配置，改用标准的用户名密码认证，注意如果你的谷歌账号开启了两步验证，需要在谷歌账号后台生成应用专用密码替换普通登录密码：

// 代码开头必须先加载dotenv
require('dotenv').config()

// 替换原有smtpTransport配置
var smtpTransport = nodemailer.createTransport({
  service: "gmail",
  auth: {
    user: process.env.Gmail_username,
    pass: process.env.Gmail_password
  }
});

方案2：补全OAuth2认证配置 #

先在谷歌云控制台获取对应应用的clientId、refreshToken参数，添加到.env文件中，再修改配置如下：

// 代码开头必须先加载dotenv
require('dotenv').config()

// 替换原有smtpTransport配置
var smtpTransport = nodemailer.createTransport({
  service: "gmail",
  auth: {
    type: "OAuth2",
    user: process.env.Gmail_username,
    clientId: process.env.GOOGLE_CLIENT_ID,
    clientSecret: process.env.Gmail_password,
    refreshToken: process.env.GOOGLE_REFRESH_TOKEN
  }
});

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