Azure DevOps SendMail Rest API返回204但未发送邮件求助

以下是针对你遇到的问题的具体排查方向和解决建议：

1. 验证API调用权限与身份 #

• 调用API的身份需具备目标项目的**「查看项目级信息」权限**，若使用个人访问令牌（PAT），需勾选Work Items类别的至少Read权限。
• 若使用服务账号调用，需确保该账号已加入目标项目成员列表，且关联邮箱在Azure AD中完成验证。

2. 修正收件人格式用法 #

• 不要同时混用tfIds和emailAddresses字段，API要求每个收件人对象（to/cc）仅能使用其中一种格式。
• 使用emailAddresses时，需确保邮箱是Azure DevOps组织内已关联的有效用户邮箱，格式为数组：

  "to": {
    "emailAddresses": ["user@your-domain.com"]
  }
  

• 使用tfIds时，需确认ID为用户的唯一标识符（可通过组织用户列表或项目成员详情获取，避免拼写错误）。

3. 检查邮件内容合规性 #

• 简化邮件body格式测试：先尝试纯文本内容（如"body": "Test Email"），排除HTML格式被邮件系统拦截的可能。
• 确保subject字段非空，避免因空主题触发垃圾邮件过滤规则。

4. 排查Azure DevOps邮件服务状态 #

• 联系组织管理员，在Azure DevOps组织设置的「通知」板块检查邮件发送配置是否正常，是否存在服务封禁或配置异常。
• 提醒收件人检查垃圾邮件文件夹，或添加Azure DevOps发件域名至邮箱白名单。

5. 优化请求参数完整性 #

• 确认projectId为项目的GUID而非项目名称（可在项目设置页面获取）。
• 删除未使用的空字段（如cc、replyTo、inReplyTo），避免API解析异常，示例JSON：

  {
    "message": {
      "body": "<p>Test Email</p>",
      "to": {
        "tfIds": ["正确的用户TFID"]
      },
      "subject": "test"
    },
    "projectId": "正确的项目GUID"
  }
  

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