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(); }
排查顺序
- 手动公网访问你拼接得到的完整
NotificationUrl地址,确认无404、500等服务错误 - 打开ngrok内置管理面板,确认Graph的验证请求已经成功发送到你的服务
- 检查通知接口的GET逻辑是否正确返回
validationToken参数
内容的提问来源于stack exchange,提问作者Peteercet
相关产品推荐
相关产品推荐

