Nodemailer联系表单本地运行正常 部署Firebase后无法发送邮件

问题根因分析 #

• 核心问题：Firebase Hosting默认仅提供静态资源托管能力，不会运行你本地编写的Express后端服务。你本地执行npm run dev时启动了Node服务处理POST请求，但直接部署静态文件到Firebase后，前端提交的POST请求没有对应的后端接口处理，直接返回错误。
• 若你已经尝试将后端部署为Firebase Functions，还可能存在以下问题：
  • 前端请求路径错误：Firebase Functions的默认触发路径不是站点根路径/，你前端代码中xhr.open('POST', '/')指向的路径和实际云函数路径不匹配
  • Gmail安全拦截：谷歌默认禁止第三方服务使用账号密码直接登录发信，部署在公共云环境的请求会被谷歌的安全策略拦截
  • 环境变量缺失：你硬编码在代码里的邮箱账号密码，部署时可能没有正确配置到Firebase环境中，导致Nodemailer鉴权失败
  • 跨域限制：云函数域名和静态站点域名不同，未配置CORS的情况下请求会被浏览器拦截
  • 套餐限制：Firebase免费Spark计划限制出站请求访问非谷歌服务，若触发限制会导致发信请求失败

具体修复步骤 #

1. 迁移后端逻辑到Firebase Functions #

先初始化Firebase Functions项目，将server.js中的发信逻辑迁移到云函数中，示例函数代码如下：

const functions = require("firebase-functions");
const nodemailer = require("nodemailer");
const cors = require('cors')({origin: true}); // 提前安装cors包处理跨域

exports.sendMail = functions.https.onRequest((req, res) => {
  cors(req, res, () => {
    const transporter = nodemailer.createTransport({
      service: 'gmail',
      auth: {
        user: functions.config().gmail.user, // 从环境变量读取账号
        pass: functions.config().gmail.pass // 从环境变量读取密码
      }
    });

    const mailOptions = {
      from: req.body.email,
      to: functions.config().gmail.user,
      subject: `Message from ${req.body.email}`,
      text: req.body.message
    };

    transporter.sendMail(mailOptions, (error, info) => {
      if(error) {
        console.log(error);
        res.send('error');
      }else{
        console.log('Email sent: ' + info.response);
        res.send('success');
      }
    });
  })
});

2. 配置环境变量 #

本地执行以下命令将邮箱信息配置到Firebase Functions环境中，不要硬编码在代码里：

firebase functions:config:set gmail.user="你的邮箱地址" gmail.pass="你的应用专用密码"

3. 处理Gmail鉴权问题 #

登录你的谷歌账号，先开启两步验证，然后生成应用专用密码，用这个密码作为上面配置的gmail.pass的值，不要使用账号本身的登录密码。
4. ### 修改前端请求地址
将app.js中的请求路径改为你部署后的云函数地址，或者配置Firebase Hosting重写规则：

• 直接修改路径的方案：将xhr.open('POST', '/')改为xhr.open('POST', '你的云函数访问地址')，云函数地址可以在Firebase控制台的Functions页面查看
• 更优的重写方案：在firebase.json中添加重写规则，将/api/sendMail的请求转发到云函数，前端就可以用相对路径/api/sendMail发送请求，避免跨域问题

5. 套餐确认 #

如果使用免费Spark计划发信仍然失败，可以升级到Blaze按需付费计划，个人低用量场景下几乎不会产生费用。

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