Gmail API连接认证失败 低安全应用访问关闭后如何接入Gmail验证邮件

你遇到的[AUTHENTICATIONFAILED] Invalid credentials报错，核心原因是谷歌2022年5月30日正式下线了「Less secure app access（低安全性应用访问权限）」配置，所有直接使用账号密码的IMAP/SMTP直连方式默认被拦截，不存在手动重新开启该权限的入口。

根据你的使用场景（校验己方发送的确认邮件，即需要读取Gmail邮箱内容），可以选择以下两种合规接入方案：

方案1：应用专用密码接入（改造成本最低，仅适用于自有固定Gmail账号场景） #

如果你只需要固定使用1个或少量属于你方所有的Gmail账号做邮件校验，不需要让普通终端用户授权接入他们的私人Gmail，优先选这个方案，原有JavaMail逻辑几乎不需要改动：

• 前置要求：目标Gmail账号必须开启两步验证（2FA），未开启2FA的账号不会显示应用专用密码生成入口
• 操作步骤：
  • 登录目标Gmail对应的Google账号，进入安全设置页，找到「应用专用密码」选项
  • 选择应用类型为「邮件」，设备类型按实际部署环境选择即可，生成16位长度的应用专用密码
  • 替换原有代码中Gmail登录的密码字段为刚生成的16位应用专用密码，连接参数保持如下即可：

# IMAP收信配置（用于读取、校验确认邮件）
mail.imap.host=imap.gmail.com
mail.imap.port=993
mail.imap.ssl.enable=true
mail.imap.user=完整Gmail邮箱地址
mail.imap.password=16位应用专用密码

• 注意：该方案生成的密码仅对指定应用场景生效，不会泄露你Gmail账号的主密码，账号两步验证关闭后已生成的应用专用密码会自动失效。

方案2：Gmail API + OAuth2.0 接入（官方推荐全场景方案） #

如果你需要面向终端用户提供Gmail接入能力，或者需要更规范的服务端自动化接入能力，选择这个谷歌官方认可的标准方案：

• 前期配置：
  • 登录Google Cloud控制台创建新项目，搜索并启用Gmail API服务
  • 进入「API和服务-凭据」页面，创建OAuth 2.0客户端ID，服务端部署选择「Web应用」类型，本地工具选择「桌面应用」类型
  • 配置OAuth同意屏：仅使用自有/组织内账号的话，将应用发布状态设为「内部」即可，无需审核；如果需要对所有普通Gmail用户开放，必须提交谷歌的应用安全审核，否则用户授权时会弹出高风险提示
• 授权逻辑：
  • 按照标准OAuth2.0流程引导账号授权，仅做邮件读取校验的话，申请gmail.readonly权限范围即可，不需要申请多余权限
  • 授权通过后拿到访问令牌、刷新令牌，替换原有JavaMail的密码认证逻辑为XOAUTH2机制认证，核心代码参考：

Properties props = new Properties();
props.put("mail.imap.ssl.enable", "true");
props.put("mail.imap.auth.mechanisms", "XOAUTH2");
Session session = Session.getInstance(props);
Store store = session.getStore("imap");
// 第三个参数传入OAuth2授权拿到的访问令牌
store.connect("imap.gmail.com", "目标Gmail邮箱地址", oauth2AccessToken);

• 服务端自动化优化：如果仅需要访问固定的企业自有Gmail账号，可以创建GCP服务账号，配置域范围委派权限，不需要手动走用户授权流程，可长期自动刷新令牌，适合无人值守的自动化校验场景。

注意：不要尝试使用非官方的绕过方案，目前谷歌已经全面封堵了无OAuth、无应用专用密码的账号直连通道，非合规接入不仅稳定性无法保障，还极易触发Gmail账号风控导致账号被限制使用。

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