SharePoint /subscriptions端点通知URL验证失败问题求助

云原生阿岚

2026-7-29

SharePoint Webhook 验证失败（AWS API Gateway）排查方向

以下是几个可能导致验证失败的潜在问题，结合你的场景逐一排查：

请求方法与参数传递问题：SharePoint 发送的验证请求是 GET 方法，并携带 validationToken 查询参数。检查你的 API Gateway 是否允许 GET 方法，且是否正确将查询参数传递给后端。如果后端未提取并返回该参数的纯文本内容，验证会直接失败。
响应格式要求：SharePoint 要求验证响应必须是纯文本格式的 validationToken 字符串，Content-Type 需设为 text/plain。如果你的 API 返回的是 JSON 包装内容（比如 {"token": "xxx"}）或 Content-Type 为 application/json，即使内容正确也会触发验证错误。
AWS WAF 或安全规则拦截：若 API Gateway 关联了 WAF，检查是否有规则拦截了微软 SharePoint 的请求 IP 段。SharePoint 的 webhook 请求来自官方 IP 范围，若 WAF 规则误判为恶意流量，会直接阻断验证请求。
API Gateway 路径匹配问题：确认注册 webhook 时填写的 URL 与 API Gateway 的部署路径完全一致，包括阶段前缀（比如 /dev/webhook/sharepoint）、大小写、末尾斜杠等。路径不匹配会导致请求返回 404，触发验证失败。
证书链完整性问题：如果使用了自定义域名的 SSL 证书，检查 AWS ACM 中的证书是否包含完整的证书链。微软服务器对证书链要求严格，缺失中间证书会导致 SSL 握手失败，无法完成验证。
API Gateway 超时与缓存设置：虽然 Postman 测试响应正常，但检查 API Gateway 的方法超时和集成超时是否设置合理（需确保在 5 秒内完成响应）。另外，若开启了 API 缓存，可能会返回旧的响应内容，干扰验证流程。