Java调用Gmail API使用Service Account（无用户）发送邮件时出现"Precondition check failed"-400 Bad Request错误求助

Hey，我之前在对接Gmail API用服务账号发邮件的时候也碰到过一模一样的“Precondition check failed”错误，这种没细节的400确实头疼，给你列几个大概率能解决问题的排查方向，你挨个试试：

1. 确认服务账号的域范围委派配置完全正确 #

这是最容易踩坑的点！你得登录Google Workspace管理员控制台，给你的服务账号开启域范围委派，并且一定要把Gmail API对应的权限添加到授权列表里：

• 发送邮件只需要添加https://www.googleapis.com/auth/gmail.send权限就够了，别多添也别少添；
• 另外必须指定要模拟的Workspace域内真实用户邮箱，服务账号本身是没有邮箱身份的，必须通过模拟域内用户才能发邮件，这一步漏了直接触发预检查失败。

2. 检查代码里的模拟用户配置 #

在Java代码获取OAuth2凭证的时候，一定要调用setServiceAccountUser("你的域内用户邮箱@yourdomain.com")，确保这里填的是你在控制台授权过的那个有效用户邮箱，拼写错了或者填了域外邮箱都会报错。

3. 确认Gmail API已在GCP项目中启用 #

别忽略这个基础操作！去Google Cloud Console找到你的项目，搜索“Gmail API”，确认它的状态是“已启用”，要是没启用的话也会报这种模糊的400错误。

4. 验证服务账号密钥的有效性 #

确保你用的是服务账号的JSON格式密钥文件，加载路径和方式都没错，要是密钥过期、无效或者加载失败，也会触发预检查不通过的问题。

最后再贴一下你提到的错误信息方便对照：

com.google.api.client.googleapis.json.GoogleJsonResponseException: 400 Bad Request
{
  "code" : 400,
  "errors" : [ {
    "domain" : "global",
    "message" : "Precondition check failed.",
    "reason" : "failedPrecondition"
  } ],
  "message" : "Precondition check failed.",
  "status" : "FAILED_PRECONDITION"
}

备注：内容来源于stack exchange，提问作者jn4