Azure Web App与Web API启用HTTP2后首请求报错排查求助

我来帮你梳理几个针对性的排查方向，解决你遇到的Azure Web App调用Web API时首个请求触发net::ERR_SPDY_PROTOCOL_ERROR且请求未到达API的问题：

1. 确认HTTP2配置的完整性 #

• 检查两个应用的Azure门户配置：确保Web API的WEBSITE_HTTP20_ENABLED设为True（控制入站HTTP2流量），同时Web App的WEBSITE_USE_HTTP2设为True（控制出站HTTP2流量）。有时候门户的开关可能只默认配置了入站，需要手动添加出站的应用设置。
• 验证Web App的最低TLS版本：HTTP2要求使用TLS 1.2及以上，在Azure门户的「TLS/SSL设置」里将最低TLS版本设为1.2，避免因旧版TLS导致协议协商失败。

2. 显式配置HttpClient启用HTTP2 #

即使升级到.NET 4.6.1，默认的HttpClient并不会自动优先使用HTTP2，你需要显式配置协议版本和TLS设置：

var handler = new HttpClientHandler
{
    // 强制使用TLS1.2，HTTP2的必备条件
    SslProtocols = SslProtocols.Tls12,
    // 仅用于测试阶段跳过证书验证，生产环境请移除或替换为合法的验证逻辑
    ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true
};

using var client = new HttpClient(handler)
{
    DefaultRequestVersion = HttpVersion.Version20,
    DefaultVersionPolicy = HttpVersionPolicy.RequestVersionOrHigher
};

配置后再测试首个请求，看是否能成功建立HTTP2连接。

3. 排查Azure实例与网络层问题 #

• 重启Web App和Web API的实例：有时候实例的网络栈状态异常会导致首次HTTP2连接失败，重启后可以重置网络状态。
• 使用Azure门户的「诊断和解决问题」工具：搜索「HTTP2」「出站连接」相关的诊断项，查看是否有连接超时、协议协商失败的日志或指标，Azure的内置诊断工具往往能捕获到应用层看不到的网络问题。

4. 捕获更详细的请求日志 #

• 启用Web App的「失败请求跟踪」和「详细错误日志」：在应用服务日志设置里开启后，触发首个请求，查看日志中是否有出站请求的记录。如果日志完全没有该请求的痕迹，说明请求在Web App的出站层就被拦截了。
• 配置Application Insights依赖项跟踪：在Web App中启用AI的依赖项采集，这样可以捕获到出站请求的详细流程，包括协议协商阶段的错误信息，帮助定位问题根源。

5. 对比HTTP1.1验证问题范围 #

临时将Web App的HttpClient强制切换到HTTP1.1（把DefaultRequestVersion设为HttpVersion.Version11），测试首个请求是否正常：

• 如果HTTP1.1正常，说明问题确实集中在HTTP2协议的协商或连接建立环节；
• 如果HTTP1.1也失败，那需要排查其他网络配置，比如VNet集成规则、防火墙出站限制、Web API的路由配置等。

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