Firebase Cloud Function(Node.js)返回200状态码但邮件未送达问题排查求助

看起来你遇到的问题是函数调用返回200，但目标邮箱始终没收到邮件，结合你的代码，我整理了几个实用的排查方向：

1. 先确认OAuth2配置是否完整且正确 #

你用的是Gmail的OAuth2认证方式，这里有两个容易踩坑的关键点：

• 域范围委派授权：如果你的info@exampledomain.com是Google Workspace企业邮箱，必须在Google Cloud Console给你的服务账号开启域范围委派，并授权https://mail.google.com/这个核心权限；如果是普通Gmail账号，要确认服务账号是否正确关联到你的个人邮箱。
• 私钥格式修正：从JSON文件读取的privateKey经常会存在转义换行符的问题（比如字符串里的\n没有被解析成实际换行），可以尝试修改私钥的读取逻辑：

  privateKey: key.private_key.replace(/\\n/g, '\n')
  

  这能确保Nodemailer正确识别私钥格式。

2. 检查目标邮箱的垃圾/促销文件夹 #

很多时候邮件其实已经发送成功，但被邮箱服务商判定为垃圾邮件。先去目标邮箱的垃圾邮件、促销邮件或者其他过滤文件夹里找一找，这是最常见的“没收到”原因。

3. 增加日志，确认邮件是否真的被Google接收 #

你的代码里发送成功只返回了Sent，没有记录详细的响应信息。建议修改代码，把发送日志打印到Firebase控制台，方便精准排查：

return transporter.sendMail(mailOptions, (erro, info) => {
    if(erro){
        console.error('邮件发送失败:', erro);
        return res.status(500).send(erro.toString());
    }
    console.log('邮件发送响应:', info.response);
    return res.send('发送成功: ' + info.response);
});

然后去Firebase控制台的函数>日志里查看详细响应，如果Google返回了类似250 2.0.0 OK的信息，说明邮件已经成功交给Google邮件服务器，问题出在后续投递环节（比如被目标邮箱拦截）。

4. 检查域名的SPF/DKIM配置 #

如果你的发件人邮箱是自定义域名（exampledomain.com），需要确保域名的DNS配置了正确的SPF和DKIM记录，这能大幅提升邮件的可信度，避免被邮箱服务商拦截。

5. 确认Gmail的发送限制 #

• 普通Gmail账号每天的发送限额是500封，Workspace账号根据套餐不同有更高限额，如果你的函数调用频率很高，可能触发了限额。
• 另外，要确保你的邮箱账号没有因为异常活动被Google限制发送邮件。

6. 检查云函数的网络连接 #

虽然默认的Firebase云函数可以访问外部网络，但如果你的函数配置了VPC网络或者防火墙规则，可能无法连接到smtp.gmail.com的465端口。可以通过日志查看是否存在连接超时或者网络错误的信息。

先从这几个方向排查，应该能快速定位问题！

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