Firebase Cloud Function报错：mailTransport未定义，邮件发送失败

嘿，我来帮你搞定这个邮件发送的问题！你遇到的mailTransport is not defined错误，基本是变量没正确定义、依赖没装对，或者作用域出了问题，咱们一步步排查：

1. 先确认nodemailer的引入与mailTransport实例创建 #

首先要确保在你的函数代码最顶部，正确引入nodemailer，并且在全局（或可访问的作用域）创建mailTransport实例：

// 必须在代码开头引入nodemailer
const nodemailer = require('nodemailer');
const functions = require('firebase-functions');

// 全局定义mailTransport，确保所有需要用它的函数都能访问到
const mailTransport = nodemailer.createTransport({
  // 这里替换成你的邮件服务配置，比如Gmail
  service: 'Gmail',
  auth: {
    user: '你的邮箱地址',
    pass: '邮箱授权码（不是登录密码！Gmail需开启两步验证后生成）'
  }
});

⚠️ 注意：千万不要用普通邮箱登录密码，大部分邮件服务商（比如Gmail）会拦截这种非授权应用的登录请求，一定要用应用专用密码或者授权码。

2. 检查nodemailer是否安装到了正确目录 #

你提到已经安装了nodemailer，但要确认是在Cloud Functions的根目录（也就是包含package.json的functions/文件夹）下执行的安装命令：

# 先进入functions目录
cd functions
# 安装并保存依赖到package.json
npm install nodemailer --save

安装完成后，打开functions/package.json，检查dependencies里是否有nodemailer这一项，确保它被正确添加。

3. 排查变量作用域问题 #

如果你的mailTransport是定义在某个函数内部（比如只在触发函数里临时创建），但在其他子函数里调用，就会出现未定义的错误。比如这种错误写法：

exports.sendEmailOnWrite = functions.database.ref('/path').onWrite((change) => {
  // 局部定义的mailTransport，外部无法访问
  const mailTransport = nodemailer.createTransport(...);
});

// 另一个函数调用mailTransport就会报错
function sendMail() {
  mailTransport.sendMail(...); // 这里就会提示未定义
}

解决办法是把mailTransport提升到全局作用域，或者确保在需要调用它的函数内部正确创建实例。

4. Firebase Cloud Functions的额外注意事项 #

• 如果你用的是Firebase免费计划，部分邮件服务的出站请求可能会被限制，比如Gmail每天的发送次数有限制，建议测试时少量发送。
• 不要硬编码邮箱账号和密码！用Firebase的环境变量来存储敏感信息更安全：

  # 设置环境变量
  firebase functions:config:set gmail.email="你的邮箱" gmail.password="你的授权码"
  

  然后在代码中读取：

  const gmailEmail = functions.config().gmail.email;
  const gmailPassword = functions.config().gmail.password;
  const mailTransport = nodemailer.createTransport({
    service: 'Gmail',
    auth: {
      user: gmailEmail,
      pass: gmailPassword
    }
  });
  

按照上面的步骤排查，应该就能解决mailTransport is not defined的问题啦！

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