Python通过ServiceAccount认证Gmail API发邮件：Heroku CLI发送异常排查

1. 确认Google Workspace全域委派配置 #

使用服务账号模拟用户发送邮件，必须依托Google Workspace（原G Suite）账号，普通个人Gmail账号不支持该功能。需完成以下配置：

• 登录Google Admin控制台，找到对应服务账号并启用全域委派。
• 在Admin控制台的「安全」→「API控制」→「域宽委派」中，添加服务账号的客户端ID，并授权https://mail.google.com/权限范围。
• 确保代码中subject参数填写的是Google Workspace内已授权的有效邮箱地址，而非普通Gmail地址。

2. 修正权限范围的URL格式 #

代码中scopes使用的是http://mail.google.com/，建议改为HTTPS协议的标准格式：

scopes=["https://mail.google.com/"]

虽HTTP格式可能通过验证，但HTTPS是官方推荐的规范写法，可避免潜在的权限验证异常。

3. 检查邮件接收方的垃圾箱与过滤规则 #

即使API返回发送成功，邮件仍可能被收件方邮箱服务商判定为垃圾邮件。请让收件人检查垃圾箱及自定义邮件过滤规则，确认邮件是否被拦截。

4. 验证Heroku环境中的凭据文件 #

确保creds.json已正确部署到Heroku：

• 通过heroku run ls命令查看应用文件目录，确认creds.json存在。
• 若用Git部署，需确保该文件未被.gitignore排除；更安全的方式是改用Heroku环境变量存储凭据内容，修改代码从环境变量读取：

import json
import os

credentials = service_account.Credentials.from_service_account_info(
    json.loads(os.environ.get('GOOGLE_SERVICE_ACCOUNT')),
    scopes=["https://mail.google.com/"],
    subject="authorisedemailaddress"
)

随后在Heroku控制台设置环境变量GOOGLE_SERVICE_ACCOUNT，值为creds.json的完整内容。

5. 测试同域邮箱接收情况 #

临时将收件邮箱改为与subject同域的Google Workspace邮箱，测试是否能正常接收，排除外部邮箱的过滤干扰。

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