使用Gmail API通过PowerShell发送别名邮件失败求助

• 编写了PowerShell脚本通过Google API发送邮件，使用账户默认地址时一切正常，但指定“发送为”地址（示例为messenger@fake.com）时，邮件提交成功且出现在已发送项中，却从未送达收件人。
• 已确认该地址在备用邮箱及“发送为”列表中，且可通过Gmail GUI以该地址正常发送邮件。
• 使用PowerShell Gallery中的GoogleOAuth2模块，已完成认证，不确定是否为模块问题，求排查方向或修改建议。

用户提供的脚本代码：

# get an access token
Import-Module GoogleOAuth2
if ((Test-IsGoogleOAuth2TokenExpired -ClientId $gmailClientId) -eq $true) {
            Update-GoogleOAuth2Token -RefreshToken $gmailRefreshToken -ClientId $gmailClientId -ClientSecret $gmailClientSecret -Persist   
        }
        $accessToken = (Get-GoogleOAuth2Token -ClientId $gmailClientId).access_token

# create raw email content
                $emailContent = @"
From: $from
To: $to
Subject: $subject

$body

"@
                # Convert to base64url (RFC 4648) - Gmail API expects this
                $bytes = [System.Text.Encoding]::UTF8.GetBytes($emailContent)
                $base64 = [System.Convert]::ToBase64String($bytes)
                $base64Url = $base64.Replace('+', '-').Replace('/', '_').Replace('=', '')

            # gmail send api endpoint
            $uri = "https://gmail.googleapis.com/gmail/v1/users/me/messages/send"

            $headers = @{
                "Authorization" = "Bearer $accessToken"
                "Content-Type"  = "application/json"
            }

            $body = @{
                raw = $base64Url
            } | ConvertTo-Json -Depth 5

            # Send rest method request
            $response = Invoke-RestMethod -Method POST -Uri $uri -Headers $headers -Body $body
            # For log and error test
            $responseId = $($response.id)
            $responseLabel = $response.labelIds

1. 规范From头格式 #

Gmail API对“发送为”地址的From头格式有严格要求，需包含显示名称和邮箱地址（用尖括号包裹），示例：

From: "Messenger" <messenger@fake.com>

避免仅写纯邮箱地址，防止解析异常。

2. 强制添加Sender头（核心修复） #

使用非默认发件人时，必须添加Sender头，值为你的主账户邮箱（即认证时的邮箱），示例：

$emailContent = @"
From: "Messenger" <messenger@fake.com>
Sender: your-main-account@gmail.com
To: $to
Subject: $subject

$body
"@

这是Gmail验证发件权限的关键字段，缺失会导致邮件被静默拦截。

3. 验证OAuth2权限范围 #

确保你的OAuth2令牌申请了https://www.googleapis.com/auth/gmail.send或https://www.googleapis.com/auth/gmail.modify权限范围，权限不足会导致邮件无法正常投递。

4. 显式指定userId（排查账户识别问题） #

将API请求中的users/me替换为你的主邮箱地址，确保API明确识别发送账户：

$uri = "https://gmail.googleapis.com/gmail/v1/users/your-main-account@gmail.com/messages/send"

5. 检查Gmail日志与原始邮件 #

• 登录Gmail网页版，进入设置→账户和导入→发送邮件地址，点击对应地址的“管理”查看发送日志。
• 在“已发送”中打开对应邮件，选择“显示原始”，检查邮件头是否符合要求，以及是否有被标记为垃圾或拦截的痕迹。

6. 绕过模块手动获取令牌（排查模块问题） #

如果怀疑GoogleOAuth2模块存在问题，可手动刷新令牌后调用API，对比结果：

# 手动刷新令牌
$tokenUri = "https://oauth2.googleapis.com/token"
$tokenBody = @{
    client_id     = $gmailClientId
    client_secret = $gmailClientSecret
    refresh_token = $gmailRefreshToken
    grant_type    = "refresh_token"
}
$tokenResponse = Invoke-RestMethod -Method Post -Uri $tokenUri -Body $tokenBody
$accessToken = $tokenResponse.access_token

# 后续发送逻辑不变，使用这个$accessToken

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