使用服务账号发邮件遭遇400 Precondition check failed错误求助

出现这个错误的核心原因是服务账号本身没有独立的Gmail邮箱身份，不能直接作为发送主体使用Gmail API，必须通过域范围委派模拟一个Google Workspace（原G Suite）域内的真实用户邮箱来发送邮件。结合你的代码，以下是具体修复步骤：

1. 配置域范围委派（必须操作） #

• 登录Google Admin控制台，找到你的服务账号，启用域范围委派。
• 添加授权范围：https://www.googleapis.com/auth/gmail.send，确保域管理员已批准该权限。

2. 修改代码中的关键问题 #

问题点1：未指定模拟用户 #

服务账号需要通过subject参数指定要模拟的域内真实用户邮箱（比如user@your-domain.com），否则无法完成身份验证。

问题点2：userId错误 #

不能使用服务账号邮箱作为userId，应该用me（代表当前授权的模拟用户）或者直接写模拟的用户邮箱。

问题点3：Base64编码不符合要求 #

Gmail API要求raw字段使用URL安全的Base64编码，需要替换普通Base64中的+为-，/为_，并去掉末尾的=。

修改后的代码：

const sendEmail = async () => {
  const auth = new google.auth.GoogleAuth({
    keyFile: "gmail.json",
    scopes: "https://www.googleapis.com/auth/gmail.send",
  });

  // 获取授权客户端时指定要模拟的域内用户邮箱
  const authClientObject = await auth.getClient();
  authClientObject.subject = "real-user@your-domain.com"; // 替换为你的域内真实用户邮箱

  const gmail = google.gmail({ version: "v1", auth: authClientObject });
  
  // 构造邮件内容
  const email = 'To: someone@jybe.ca\r\n' +
                `Cc: someoneelse@jybe.ca\r\n` +
                'Subject: CUSTOM DONATION ALERT\r\n\r\n' +
                'blablabla\r\n';
  
  // 转换为URL安全的Base64编码
  const base64EncodedEmail = Buffer.from(email)
    .toString('base64')
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '');
  
  // 发送邮件，userId使用"me"
  try {
    const res = await gmail.users.messages.send({
      userId: "me",
      resource: {
        raw: base64EncodedEmail,
      },
    });
    console.log('Email sent:', res.data);
  } catch (err) {
    console.error('Error sending email:', err);
  }
}

额外检查项 #

• 确认模拟的用户邮箱在你的Workspace域内，且没有被限制发送邮件。
• 检查服务账号的Owner角色是否包含了Gmail API的访问权限（通常Owner权限足够，但需确保域委派已生效）。

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