调用Azure DevOps SendMail API成功却未收到邮件的问题咨询

这个API是可以正常工作的，我之前在管道里成功使用过。针对你遇到的问题，给你几个排查方向和解决方案：

1. 权限验证是核心 #

管道中使用的身份（比如服务主体、系统访问令牌）必须拥有发送邮件的权限：

• 进入项目设置 → 权限 → 用户权限，找到对应的身份（比如管道的服务主体，或者“Project Collection Build Service ({组织名})”）
• 确保“发送邮件”权限被设置为“允许”，默认情况下非管理员身份可能没有这个权限

2. 请求体优化，优先使用TFS ID #

虽然API支持传入邮箱地址，但ADO内部优先识别用户的TFS ID，建议补充用户的TFS ID到请求体中：

• 可以通过Get User API获取目标用户的TFS ID（比如调用_apis/identities?searchFilter=General&value=test@fakedomain.com）
• 调整请求体的to字段，同时传入tfsIds和emailAddresses，示例如下：

{
    "message": {
        "subject": "This is a test of the Azure DevOps SendMail REST Endpoint",
        "body": "Was this email received?",
        "cc": {
            "tfsIds": [],
            "emailAddresses": [],
            "unresolvedEntityIds": []       
        },
        "inReplyTo": "",
        "to": {
            "tfsIds": ["用户的TFS ID"],
            "emailAddresses": ["test@fakedomain.com"],
            "unresolvedEntityIds": []
        },
        "replyTo": {
            "tfsIds": [],
            "emailAddresses": ["test@fakedomain.com"],
            "unresolvedEntityIds": []
        }
    }
}

3. 管道调用的细节检查 #

• 确保请求头包含Content-Type: application/json，这是很多人忽略的点，缺少的话API可能返回204但实际未处理邮件
• 如果用ADO管道的系统访问令牌（System.AccessToken），需要在管道设置中勾选“允许脚本访问OAuth令牌”
• 可以在管道中增加日志输出，打印完整的请求信息（包括身份验证头），确认请求没有异常

4. 额外排查步骤 #

• 用个人PAT（拥有完整权限）在本地工具中调用同一个API，如果能收到邮件，说明是管道身份的权限问题；如果还是收不到，检查组织的邮件设置是否有拦截规则
• 查看组织的审计日志（组织设置 → 审计），搜索“sendmail”操作，查看是否有隐藏的错误提示

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