使用Microsoft Graph API应用令牌无法获取主事件问题排查

核心问题1：应用权限的Scope使用错误 #

应用权限模式下，Microsoft Graph要求使用https://graph.microsoft.com/.default作为请求令牌的scope，而非委托权限中使用的具体权限（如Calendars.Read）。应用权限是预先在Azure AD中分配给应用的，通过/.default scope可以获取所有已授予的应用权限范围。你当前代码中使用的Calendars.Read scope仅适用于委托权限模式，这会导致应用令牌无法正确获取到所需的应用权限。

核心问题2：应用权限下默认不返回系列主事件 #

即使权限正确，应用权限调用Graph API获取日历事件时，默认不会返回系列主事件（Series Master），必须通过$filter参数显式筛选类型为seriesMaster的事件。而委托权限模式下，API默认会返回系列主事件，这就是两种令牌表现不同的原因。

修改后的代码示例 #

// 应用权限模式下必须使用/.default作为scope
var scopes = new[] { "https://graph.microsoft.com/.default" };

var options = new ClientSecretCredentialOptions
{
    AuthorityHost = AzureAuthorityHosts.AzurePublicCloud,
};

var clientSecretCredential = new ClientSecretCredential(TenantId, ClientId, ClientSecret, options);
var graphClient = new GraphServiceClient(clientSecretCredential, scopes);

// 获取系列主事件，显式添加Filter筛选类型
var seriesMasters = await graphClient.Users[userId].Events.GetAsync((requestConfiguration) =>
{
    requestConfiguration.QueryParameters.Select = new string[] { "subject","seriesMasterId","type","recurrence","start","end" };
    // 筛选出系列主事件
    requestConfiguration.QueryParameters.Filter = "type eq 'seriesMaster'";
});

// 如果需要同时获取实例事件和主事件，可以拆分请求或者调整筛选条件
var allEvents = await graphClient.Users[userId].Calendar.Events.GetAsync((requestConfiguration) =>
{
    requestConfiguration.QueryParameters.Select = new string[] { "subject","seriesMasterId","type","recurrence","start","end" };
    // 可选：同时获取主事件和单个实例
    requestConfiguration.QueryParameters.Filter = "type eq 'seriesMaster' or type eq 'singleInstance'";
});

额外验证步骤 #

1. 确认Azure AD中已给应用分配应用权限的Calendars.Read（而非委托权限），并且完成了管理员同意。
2. 重新获取令牌后，通过jwt.io验证令牌的roles字段是否包含Calendars.Read（应用权限会在roles字段，委托权限在scp字段）。

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