.NET 6.0 gRPC请求在特定机器失败，需HTTP 2.0，求故障排查方案

可能的原因 #

网络问题 #

• 当前机器的网络环境（防火墙、代理、内网规则）拦截了HTTP/2连接，或者不支持ALPN（应用层协议协商，HTTP/2 over TLS的必备机制）。
• 网络路由存在限制，比如企业内网禁用了HTTP/2相关的端口或协议。

.NET环境/系统配置问题 #

• 目标机器的.NET 6.0运行时缺失或损坏，导致HTTP/2相关组件无法正常工作。
• 系统版本不兼容：Windows 7及更早版本默认不支持HTTP/2；Linux系统缺少必要的TLS依赖（如OpenSSL 1.0.2+）。
• 应用未配置降级逻辑：gRPC默认依赖HTTP/2，若未处理连接失败的 fallback 策略，会直接抛出错误。

其他原因 #

• 目标gRPC服务端的TLS证书无效，导致握手失败，间接阻碍HTTP/2连接建立。
• 客户端代码强制指定了HTTP/2版本策略，但当前环境无法满足要求。

检测HTTP/2可用性的方法 #

1. .NET代码检测 #

编写简单的控制台程序，测试与HTTP/2服务的连接：

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Http2Test
{
    static async Task Main(string[] args)
    {
        using var client = new HttpClient();
        client.DefaultRequestVersion = new Version(2, 0);
        client.DefaultVersionPolicy = HttpVersionPolicy.RequestVersionOrHigher;
        
        try
        {
            // 可替换为你的gRPC服务域名（需HTTPS）
            var response = await client.GetAsync("https://www.google.com"); 
            Console.WriteLine($"实际使用HTTP版本: {response.Version}");
            Console.WriteLine("HTTP/2连接成功");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"连接失败: {ex.Message}");
        }
    }
}

编译运行后，根据输出判断HTTP/2是否可用。

2. 系统层面检测 #

Windows系统

• 打开命令提示符，执行：netsh http show servicestate，查看输出中是否包含HTTP/2相关配置；也可通过注册表检查：

  reg query HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters
  

  确认EnableHttp2Tls和EnableHttp2Cleartext的键值为1（表示启用）。
• 用浏览器访问支持HTTP/2的网站，在开发者工具的「网络」面板中查看请求的协议版本。

Linux系统

• 执行curl命令测试：

  curl --http2 -I https://www.google.com
  

  若响应头包含HTTP/2 200则HTTP/2可用；报错则说明环境不支持。
• 检查OpenSSL版本：

  openssl version
  

  确保版本在1.0.2及以上。

3. gRPC客户端配置排查 #

检查客户端代码，确认是否强制指定了HTTP/2版本策略，若服务端支持gRPC-Web，可尝试配置回退到HTTP/1.1的逻辑（仅适用于gRPC-Web场景）。

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