You need to enable JavaScript to run this app. Microsoft Graph订阅验证请求失败 是否为NotificationUrl配置问题
优惠活动
大模型
产品
解决方案
定价
更多

Microsoft Graph订阅验证请求失败 是否为NotificationUrl配置问题

Subscription validation request failed. Notification endpoint must respond with 200 OK to validation request

这个报错不一定完全由NotificationUrl配置异常导致,它是Microsoft Graph订阅创建流程的校验规则触发的结果:你提交订阅创建请求后,Graph会立即向你填写的通知端点发送一个GET验证请求,要求端点10秒内返回状态码200 OK,且响应体原样回传请求携带的validationToken参数,只要不满足要求就会抛出该错误。

常见触发原因

1. NotificationUrl配置问题

  • 配置的config.ngrok地址拼写错误,或者ngrok服务未启动、没有正确映射到你本地承载/api/notifications接口的服务
  • 地址未带https前缀:Graph要求通知端点必须是公网可访问的HTTPS地址,不支持HTTP、本地localhost类地址
  • 地址拼接错误:比如ngrok地址末尾自带斜杠,拼接后出现https://xxx.ngrok.io//api/notifications这类带双斜杠的无效地址

2. 通知端点实现问题

你贴的代码是创建订阅的接口逻辑,不是/api/notifications对应的通知处理接口代码,该接口实现不符合要求也会触发报错,必须满足以下规则:

  • 同时支持GET、POST两种请求方式:GET用于处理Graph的校验逻辑,POST用于接收后续的资源变更通知
  • 处理GET请求时,必须从查询参数中取出validationToken,直接作为响应体返回,同时返回200状态码

参考实现(C# Azure Function场景):

[FunctionName("Notifications")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)
{
    // 处理Graph验证请求
    if (req.Method == HttpMethods.Get)
    {
        var validationToken = req.Query["validationToken"];
        if (!string.IsNullOrEmpty(validationToken))
        {
            return new OkObjectResult(validationToken);
        }
        return new BadRequestResult();
    }

    // 处理变更通知逻辑
    var requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    log.LogInformation($"收到资源变更通知:{requestBody}");
    return new OkResult();
}

排查顺序

  1. 手动公网访问你拼接得到的完整NotificationUrl地址,确认无404、500等服务错误
  2. 打开ngrok内置管理面板,确认Graph的验证请求已经成功发送到你的服务
  3. 检查通知接口的GET逻辑是否正确返回validationToken参数

内容的提问来源于stack exchange,提问作者Peteercet

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 21:06:08