Chrome扩展调用Gmail API无法发送邮件，请问有哪些排查解决方法？

问题排查与修复方案 #

• Gmail API调用参数缺失

  gmail.users.messages.send方法要求第一个参数必须传入userId，通常用me指代当前已授权的账号，你当前的代码直接把resource作为第一个参数传入，接口无法识别请求主体，直接导致请求失败。

• Raw字段编码不符合要求

  Gmail API要求邮件内容必须是URL安全的Base64编码，普通Base64中的+、/符号需要替换为-、_，同时要删除末尾的补位=符号，你当前使用的硬编码Base64没有做兼容处理，会触发400错误。同时你硬编码了邮件内容，完全没有使用传入的收件人、主题、正文参数，就算请求成功也不会发送你指定的内容。

• 授权逻辑缺少错误判断

  你在chrome.identity.getAuthToken的回调中没有校验token是否获取成功，也没有处理用户拒绝授权的场景，要是授权环节失败，后续的Gmail API调用都会直接报错。你需要先确认Google Cloud控制台的OAuth 2.0客户端ID配置中，已经正确填写了你的Chrome扩展ID，否则授权环节会直接失败。

• 回调格式错误

  gapi客户端的请求返回的是Promise对象，你当前使用的回调传参格式不对，无法捕获到正确的错误和返回结果，建议改用.then()和.catch()处理异步结果，方便定位具体报错信息。

关键代码修复示例 #

1. 新增URL安全Base64编码与邮件构造函数

// 转换为URL安全的Base64编码
function urlSafeBase64Encode(str) {
  return btoa(
    encodeURIComponent(str).replace(/%([0-9A-F]{2})/g, (match, p1) => 
      String.fromCharCode('0x' + p1)
    )
  )
  .replace(/\+/g, '-')
  .replace(/\//g, '_')
  .replace(/=+$/, '');
}

// 构造符合标准的邮件内容
function buildRawEmail(from, to, subject, content) {
  const email = [
    `From: ${from}`,
    `To: ${to}`,
    // 兼容中文主题编码
    `Subject: =?UTF-8?B?${btoa(unescape(encodeURIComponent(subject)))}?=`,
    'Content-Type: text/plain; charset=utf-8',
    '',
    content
  ].join('\n');
  return urlSafeBase64Encode(email);
}

2. 修正sendMessage函数

function sendMessage(auth, from, to, subject, content) {
  const encodedEmail = buildRawEmail(from, to, subject, content);
  gmail.users.messages.send({
    userId: 'me', // 必须补充该参数
    resource: {
      raw: encodedEmail
    }
  })
  .then(result => console.log('发送成功：', result))
  .catch(err => console.error('发送失败：', err.result.error));
}

额外优化建议 #

你当前使用的Gmail权限是gmail.modify，权限范围过大，仅发送邮件只需要申请https://www.googleapis.com/auth/gmail.send权限即可，可直接修改manifest.json中oauth2的scopes配置降低权限风险。

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