使用Microsoft Graph获取邮箱时遇「text/html无解析工厂」错误求助

错误原因 #

这个错误说明请求未返回预期的JSON响应，反而获取到了HTML内容（通常是权限验证失败的错误页面），核心问题大概率是权限配置不当，或API调用逻辑与需求不匹配。

修复步骤 #

1. 配置正确的应用权限 #

使用ClientSecretCredential属于应用权限模式，需在Azure AD门户完成以下操作：

• 找到你的应用注册，进入「API权限」页面
• 添加Microsoft Graph的应用权限：
  • 若要获取邮箱设置，添加MailboxSettings.Read
  • 若要获取邮件（你的代码注释标注需求为获取邮件，但实际调用的是邮箱设置接口），添加Mail.Read或Mail.ReadWrite
• 点击「授予管理员同意」，确保权限生效

2. 修正API调用（匹配实际需求） #

你的代码注释写的是"获取特定用户的邮件"，但实际调用的是邮箱设置接口。若目标是获取邮件，修改API调用如下：

// 获取特定用户的前10封邮件（可调整数量和返回字段）
var result = await graphClient.Users["<<MyMail>>"].Messages.GetAsync(requestConfiguration =>
{
    requestConfiguration.QueryParameters.Top = 10;
    requestConfiguration.QueryParameters.Select = new string[] { "Subject", "From", "ReceivedDateTime" };
});

3. 指定正确的权限范围 #

创建GraphServiceClient时，需明确应用权限的范围（应用权限固定使用https://graph.microsoft.com/.default）：

GraphServiceClient graphClient = new GraphServiceClient(credentials, new[] { "https://graph.microsoft.com/.default" });

4. 基础信息校验 #

• 确认TenantId、ClientId、ClientSecret参数完全正确
• 确认<<MyMail>>是租户内的有效用户邮箱
• 检查应用注册未被限制访问Microsoft Graph

修复后完整示例代码 #

try
{
    var credentials = new ClientSecretCredential(
        "TenantId",
        "ClientId",
        "ClientSecret",
        new TokenCredentialOptions { AuthorityHost = AzureAuthorityHosts.AzurePublicCloud });

    // 指定应用权限范围
    GraphServiceClient graphClient = new GraphServiceClient(credentials, new[] { "https://graph.microsoft.com/.default" });

    // 示例：获取邮箱设置
    var mailboxSettings = await graphClient.Users["<<MyMail>>"].MailboxSettings.GetAsync();

    // 示例：获取用户邮件（若实际需求为此，注释上方代码，取消下方注释）
    // var messages = await graphClient.Users["<<MyMail>>"].Messages.GetAsync(requestConfiguration =>
    // {
    //     requestConfiguration.QueryParameters.Top = 10;
    // });

}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
    Console.WriteLine(ex.InnerException?.ToString());
    Console.ReadLine();
}

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