基于Microsoft Graph访问政务云邮箱的C#守护程序开发求助

一、先理清政务云与商用云的核心差异 #

• Graph端点：不用国际版的https://graph.microsoft.com，改用政务云专用的https://microsoftgraph.chinacloudapi.cn
• 授权地址：替换为https://login.chinacloudapi.cn/{tenant_id}，别用login.microsoftonline.com
• Scope设置：守护程序用客户端凭据流时，必须用https://microsoftgraph.chinacloudapi.cn/.default，不能用商用云的scope格式

二、C#代码实现步骤 #

1. 安装必要NuGet包：Microsoft.Graph 和 Azure.Identity（这两个包足够，不用装一堆冗余包）
2. 核心代码示例：

using Microsoft.Graph;
using Azure.Identity;

// 替换为你的政务云凭据
var tenantId = "你的tenant_id";
var clientId = "你的client_id";
var clientSecret = "你的client_secret";
var targetMailbox = "目标用户邮箱地址";

// 配置政务云专属的认证和Graph客户端
var authOptions = new ClientSecretCredentialOptions
{
    AuthorityHost = AzureAuthorityHosts.AzureChinaCloud
};

var credential = new ClientSecretCredential(tenantId, clientId, clientSecret, authOptions);
var graphClient = new GraphServiceClient(credential, new[] { "https://microsoftgraph.chinacloudapi.cn/.default" });

// 拉取符合条件的带附件邮件（示例：筛选主题含"注册对象"的邮件）
var targetMessages = await graphClient.Users[targetMailbox].Messages
    .Request()
    .Filter("contains(Subject, '注册对象') and hasAttachments eq true")
    .Select("Subject, ReceivedDateTime, Attachments")
    .GetAsync();

// 解析邮件和附件
foreach (var msg in targetMessages)
{
    Console.WriteLine($"找到目标邮件：{msg.Subject} | 接收时间：{msg.ReceivedDateTime}");
    if (msg.Attachments != null)
    {
        foreach (var att in msg.Attachments)
        {
            if (att is FileAttachment fileAtt)
            {
                // 这里可以根据需求处理附件，比如保存到本地
                File.WriteAllBytes(fileAtt.Name, fileAtt.ContentBytes);
            }
        }
    }
}

三、权限配置必须注意的点 #

• 给应用分配应用权限（不是委派权限）：守护程序是后台运行，没有用户交互，委派权限不生效
• 所需核心权限：Mail.Read（读取邮箱内容及附件），必须让管理员在政务云AD后台完成管理员同意操作
• 权限生效延迟：政务云的权限同步可能需要5-10分钟，分配完别立刻测试，等一会儿再试

四、常见报错排查 #

• 报invalid authority：检查AuthorityHost是否设为AzureAuthorityHosts.AzureChinaCloud，或者手动指定https://login.chinacloudapi.cn
• 报insufficient privileges：确认是应用权限且已完成管理员同意，别用委派权限凑数
• 尽量别用用户名密码流（ROPC）：多数政务云租户禁用了该认证方式，客户端凭据流是最稳定的选择

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