Node.js中Gmail API服务账户认证报错401 Login Required如何解决

核心错误点 #

• 身份认证配置方式错误：你将keyFile、scopes等认证参数直接传入了gmail实例构造函数，这些参数不会被Gmail客户端识别，等于没有完成身份校验，直接触发401未登录错误。
• 缺少模拟用户配置：Service Account本身没有Gmail邮箱权限，必须配置全域委派后指定要模拟的Google Workspace用户邮箱作为subject参数，才能调用Gmail接口，你当前代码没有该配置。
• 前置权限遗漏（需先确认）：
  • GCP控制台对应项目需要先开启Gmail API
  • Google Workspace管理后台需要给该Service Account的客户端ID授权https://www.googleapis.com/auth/gmail.send scope
  • 仅Google Workspace付费账号支持Service Account调用Gmail API，个人免费Gmail账号无法使用该方案

修正后代码 #

const { gmail } = require("@googleapis/gmail");
const { GoogleAuth } = require("google-auth-library");

function createMessage(from, to, subject, message) {
  // logic that returns base64 email
  const encodedMail=[...];
  return encodedMail;
}

export default async function handler(req, res) {
  // 先单独初始化身份认证客户端
  const auth = new GoogleAuth({
    keyFile: './google_service.json',
    scopes: ["https://www.googleapis.com/auth/gmail.send"],
    // 必须指定要模拟的Google Workspace用户邮箱，即你发件使用的邮箱
    subject: process.env.SERVICE_EMAIL
  });

  // 把认证实例传给gmail客户端
  const gmailClient = gmail({
    version: "v1",
    auth: auth
  });

  const raw = createMessage(
    process.env.SERVICE_EMAIL,
    "someone@gmail.com",
    "Subject",
    "This is a test",
  );

  try {
    const result = await gmailClient.users.messages.send({
      userId: "me",
      requestBody: {
        raw,
      },
    });
    console.log(result.data);
    res.status(200).json(result.data);
  } catch (err) {
    console.log(err);
    res.status(500).json({error: err.message});
  }
}

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