自定义域名GSuite账户SMTP发件遇5.5.1认证错误求助

我之前也踩过G Suite自定义域名邮箱的SMTP认证坑，结合你提到的测试情况（普通Gmail账户完全正常），问题肯定出在G Suite的域级管理员配置上——这也是它和普通个人账户最核心的区别。给你几个针对性的排查和解决步骤：

1. 检查G Suite管理员控制台的SMTP中继权限 #

登录Google管理员后台（admin.google.com），按路径找配置：

• 进入「应用」→「G Suite」→「Gmail」→「高级设置」
• 找到「SMTP中继服务」，确认你的客户端IP地址或整个域名被允许使用SMTP中继；如果开启了「仅允许已验证的发件人」，要确保你的发件邮箱属于验证过的域
• 另外检查「安全性」→「访问和数据控制」→「API控件」，有没有限制SMTP相关的API访问权限

2. 确认域级「不太安全的应用访问」设置 #

普通Gmail的「不太安全的应用」是个人账户设置，但G Suite由管理员统一管控：

• 在管理员控制台进入「安全性」→「基本设置」→「不太安全的应用访问」
• 测试阶段可以先设置为「允许所有用户访问」，或者「允许用户管理自己的访问权限」；如果你的域启用了2FA，这个设置会自动失效，必须用应用专用密码

3. 应用专用密码的正确配置（针对2FA开启场景） #

如果你的G Suite账户开了2FA，主密码无法直接用于SMTP，必须用应用专用密码，且要确保管理员允许创建：

• 管理员控制台进入「安全性」→「多因素身份验证」→「应用专用密码」，确认已开启「允许用户创建应用专用密码」
• 用自定义域名邮箱登录myaccount.google.com，进入「安全性」→「应用专用密码」，创建一个专门用于SMTP的密码（选择「邮件」作为应用类型）
• 代码中替换主密码为这个应用专用密码，同时确保SMTP端口用587（TLS）或465（SSL）

4. 检查域名的邮件认证记录（SPF/DKIM/DMARC） #

虽然这主要影响邮件投递成功率，但部分情况下也会影响SMTP认证：

• 登录你的域名服务商后台，确认SPF记录包含include:_spf.google.com
• 确认DKIM已在G Suite控制台生成并添加到域名解析中
• DMARC记录配置正确（至少设置为v=DMARC1; p=none; sp=none; rua=mailto:dmarc@clientdomain.co.uk）

5. 用命令行手动测试SMTP连接 #

如果代码调试麻烦，用命令行工具快速验证配置是否有效（以telnet为例）：

telnet smtp.gmail.com 587
EHLO clientdomain.co.uk
STARTTLS
AUTH LOGIN
# 输入Base64编码的用户名（system@clientdomain.co.uk）
# 输入Base64编码的密码（应用专用密码或主密码）
MAIL FROM:<system@clientdomain.co.uk>
RCPT TO:<test@example.com>
DATA
Subject: Test Email
This is a test from G Suite custom domain.
.
QUIT

如果手动测试也报错，说明是配置问题而非代码问题；如果手动成功，那可能是代码里的SMTP细节（比如TLS启用时机、用户名格式）有疏漏

我当时就是因为管理员没开启「应用专用密码」的权限，折腾了大半天，开启后立刻就正常了——G Suite的域级管控很容易被忽略，这也是和普通Gmail账户的关键差异点。

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