本地调试.NET Core gRPC微服务遇HTTP/2握手失败问题求助

核心问题分析 #

WorkflowService（端口44394）调用UserManagementService（端口44322）的processhistory API时，出现Grpc.Core.RpcException: Status(StatusCode="Unavailable")错误，根源是HTTP/2连接无法建立，服务端未完成握手，连接被远程主机强制关闭。已执行dotnet dev-certs https --trust但问题未解决，可按以下步骤排查：

1. 确认UserManagementService的端口监听与HTTP/2配置 #

• 检查端口占用：执行命令netstat -ano | findstr :44322，确认44322端口被UserManagementService进程占用，避免端口冲突。
• 强制启用HTTP/2：在UserManagementService的Program.cs中配置Kestrel明确支持HTTP/2：

  builder.WebHost.ConfigureKestrel(options =>
  {
      options.ListenLocalhost(44322, o =>
      {
          o.Protocols = HttpProtocols.Http2; // 或Http1AndHttp2，确保包含Http2
          o.UseHttps();
      });
  });
  

• 验证配置文件：检查appsettings.json中的Kestrel端点配置是否正确：

  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "https://localhost:44322",
        "Protocols": "Http2"
      }
    }
  }
  

2. 检查WorkflowService的gRPC客户端地址配置 #

• 确保客户端使用HTTPS协议连接，地址为https://localhost:44322，而非HTTP地址（gRPC默认要求HTTPS）。示例客户端初始化代码：

  var channel = GrpcChannel.ForAddress("https://localhost:44322");
  var client = new UserManagementService.Protos.ProcessHistoryService.ProcessHistoryServiceClient(channel);
  

• 确认端口号与UserManagementService的监听端口完全一致，无拼写错误。

3. 重新生成并验证HTTPS开发证书 #

• 清理旧证书并重新生成信任：

  dotnet dev-certs https --clean
  dotnet dev-certs https --trust
  

• 打开certmgr.msc，导航至受信任的根证书颁发机构 > 证书，确认存在ASP.NET Core HTTPS Development Certificate且未过期。

4. 排除防火墙与代理干扰 #

• 临时关闭本地防火墙，测试是否能建立连接（避免防火墙拦截44322端口的HTTPS请求）。
• 关闭所有代理工具（如Fiddler、Charles），这类工具可能拦截HTTPS握手导致连接失败。

5. 直接测试UserManagementService的gRPC接口 #

• 使用gRPCurl或Postman的gRPC功能直接调用目标接口，验证服务本身是否正常：

  # 替换为实际的服务名、方法名和请求参数
  grpcurl -insecure -d '{"userId": 1}' localhost:44322 UserManagementService.Protos.ProcessHistoryService/ProcessHistory
  

  如果直接调用也失败，说明问题出在UserManagementService的启动或配置上，而非WorkflowService的调用逻辑。

6. 确认NuGet包版本兼容性 #

• 确保两个服务的gRPC相关NuGet包版本一致（如Grpc.AspNetCore、Grpc.Net.Client），版本不兼容可能导致HTTP/2握手异常。

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