NodeMailer结合Gmail API在AWS Lambda中无法正常运行问题

嘿，我之前也碰到过一模一样的坑！本地跑Nodemailer发Gmail顺得不行，一部署到Lambda就哑火——函数明明显示执行成功，邮件却死活收不到。我来给你拆解几个最可能的原因和亲测有效的解决办法：

1. Gmail的安全拦截（最常见元凶） #

你现在用的是账号密码直接登录，本地能跑是因为你的个人设备在Google的信任列表里，但Lambda的服务器属于陌生环境，Gmail会直接拦截这种“非信任设备”的登录请求，哪怕你密码输对了也没用。

解决办法： #

• 优先用App密码（强烈推荐）：如果你的Google账号开了两步验证，直接生成一个专门的App密码代替普通密码就行。步骤很简单：
  1. 登录Google账号，进「安全」设置页
  2. 找「App密码」（只有开了2FA才会显示这个选项）
  3. 生成一个对应“邮件”的App密码，替换代码里的pass: 'xxx'
• 要是没开2FA，你可以试试开「不太安全的应用访问」，但注意Google已经逐步淘汰这个功能了，能不用就不用。

2. Lambda的网络被限制了 #

Lambda默认如果配置了VPC，大概率是跑在私有子网里的，私有子网没法直接访问公网——而Gmail的SMTP服务器需要公网连接才能通。这时候函数虽然能执行，但连不上Gmail的服务器，邮件自然发不出去。

解决办法： #

• 如果你不需要VPC，直接把Lambda的VPC配置改成「不配置VPC」，让它跑在AWS的公共子网里，就能直接连公网了。
• 要是必须用VPC，那就得给你的子网配个NAT网关，让Lambda能通过NAT网关访问公网。

3. 异步代码写冲突了 #

看你的代码，sendMail同时用了await和回调函数，这会搞乱异步逻辑的！await是等Promise完成，但回调函数的存在会让Lambda可能在邮件发送完成前就结束执行了——表面上函数成功了，其实邮件还没发出去。

解决办法： #

把回调函数删掉，只用await，再加个try/catch抓错误，还能在日志里看到问题：

var nodemailer = require('nodemailer');
var transporter = await nodemailer.createTransport({
    service: 'Gmail',
    auth: {
        user: 'xx@usr.com',
        pass: '你的App密码'
    }
});
console.log("Starting");
try {
    const info = await transporter.sendMail({
        from: 'xx@google.com',
        to: 'xx@google.com',
        subject: 'Hello !',
        text: "Hello"
    });
    console.log('邮件发送成功:', info.messageId);
} catch (error) {
    console.error('邮件发送失败:', error);
}

4. 去CloudWatch日志里找真相 #

有时候Lambda显示“执行成功”只是函数没抛出致命错误，但邮件发送的错误被吞了。这时候你得去CloudWatch日志里看看具体的报错信息，比如是连接超时、认证失败还是啥别的问题。

怎么看日志： #

• 进AWS Lambda控制台，找到你的函数，点「监控」标签，再点「查看CloudWatch日志」
• 翻日志找错误输出，比如ETIMEDOUT就是网络连不上，Invalid login就是认证有问题，一看就懂。

额外建议：换成Gmail API的OAuth2认证 #

如果是长期用的服务，别再用账号密码了，改用Gmail API的OAuth2认证更安全，也不会受Google的安全限制。Nodemailer完全支持这种方式，你只需要在Google Cloud Console里创建个项目，启用Gmail API，生成OAuth2凭证就行。

简单示例： #

var nodemailer = require('nodemailer');
var transporter = nodemailer.createTransport({
    service: 'Gmail',
    auth: {
        type: 'OAuth2',
        user: 'xx@usr.com',
        clientId: '你的Google Cloud客户端ID',
        clientSecret: '你的Google Cloud客户端密钥',
        refreshToken: '你的刷新令牌'
    }
});
// 后续sendMail逻辑和之前一样，用await就行

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