Node.js调用Gmail API发送邮件失败，官方方案无效求助

既然你已经在API Explorer里验证了make_body生成的raw内容完全有效，那问题肯定出在Node.js代码对这个参数的处理或者请求构建环节上。我给你梳理几个最可能的排查方向和修复方案：

1. 确认raw内容的URL安全Base64编码 #

Gmail API要求raw参数必须是URL安全的Base64编码，而不是普通Base64。很多人在这里踩坑：普通Base64的+、/、末尾=这些字符会被HTTP请求解析成特殊符号，导致API无法识别。

修复代码示例：

// 假设make_body返回的是原始RFC822格式的邮件字符串
const rawMessage = make_body(/* 你的发件人、收件人、内容参数 */);
// 转换为URL安全的Base64
const encodedMessage = Buffer.from(rawMessage)
  .toString('base64')
  .replace(/\+/g, '-') // 替换+为-
  .replace(/\//g, '_') // 替换/为_
  .replace(/=+$/, ''); // 去掉末尾所有=

2. 检查请求体的格式是否正确 #

Gmail API的send接口要求请求体是一个JSON对象，raw字段要包裹在这个对象里，不能直接把编码后的字符串作为请求体发送。

如果你用Google官方的googleapis库： #

const { google } = require('googleapis');
const gmail = google.gmail({ version: 'v1', auth: yourAuthClient });

const response = await gmail.users.messages.send({
  userId: 'me',
  requestBody: {
    raw: encodedMessage // 必须放在requestBody的raw字段里
  }
});

如果你用axios/fetch这类原生HTTP库： #

要确保设置Content-Type: application/json，并且请求体是JSON字符串：

// axios示例
await axios.post(
  'https://gmail.googleapis.com/gmail/v1/users/me/messages/send',
  { raw: encodedMessage }, // 这里是JSON对象，axios会自动转字符串
  { headers: { Authorization: `Bearer ${yourAccessToken}` } }
);

3. 对比程序与API Explorer的raw参数 #

把代码里最终生成的encodedMessage打印出来，复制到API Explorer里再测试一遍：

• 如果能成功发送，说明你的请求构建有问题（比如没包裹成JSON、请求头不对）；
• 如果不能成功，说明编码后的字符串和你在API Explorer里用的有差异，回头检查make_body的换行符（必须用\r\n，不能是\n，这是RFC822的硬性要求）。

4. 确认OAuth令牌的权限 #

虽然API Explorer能成功，但还是要确认你的令牌有没有https://www.googleapis.com/auth/gmail.send这个scope。如果用的是服务账号，还要确保已经完成域范围委派，并且目标发件邮箱已被授权。

如果以上步骤都试过还是不行，把你代码里构建请求的那部分贴出来，我可以帮你精准定位问题。

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