C# .NET Framework gRPC客户端连接Python gRPC服务器报错求助

问题背景 #

基于C# .NET Framework 4.7.x开发gRPC客户端，连接树莓派上Python 3.7的gRPC服务器。无SSL的Python客户端通信正常，但C#客户端因不支持无SSL连接，改用带自签名证书的SSL服务器后出现两类错误：

1. 设置GrpcWebMode = GrpcWebMode.GrpcWebText时：
   • 客户端报错：Grpc.Core.RpcException: 'Status(StatusCode="Unimplemented", Detail="b'/AaesIoServer.Board/GetDigital' requires exactly one request message.")'
   • 服务器报错：28997 hpack_parser.cc:1218] Error parsing metadata: error=invalid value key=content-type value=application/grpc-web-text
2. 设置GrpcWebMode = GrpcWebMode.GrpcWeb或不设置时：
   • 客户端报错：Grpc.Core.RpcException: 'Status(StatusCode="Unauthenticated", Detail="Invalid signature")'
   • 服务器报错：28997 hpack_parser.cc:1218] Error parsing metadata: error=invalid value key=content-type value=application/grpc-web

核心问题与修复步骤 #

1. gRPC Web与标准gRPC服务器不兼容 #

Python gRPC服务器默认是标准gRPC服务，不直接支持gRPC Web协议。C#客户端使用GrpcWebHandler会发送gRPC Web格式请求，导致服务器无法解析content-type头，同时请求格式不匹配引发报错。

修复：
移除C#客户端的GrpcWebHandler，直接使用标准gRPC SSL通道。修改后代码：

class Program
{
    static async Task Main(string[] args)
    {
        await DoCall(args[0]);
    }

    static async Task DoCall(string url)
    {
        // 加载服务器证书，跳过自签名验证（仅测试环境使用）
        var channelCredentials = new SslCredentials(
            File.ReadAllText("sslCred\\server.crt"),
            null,
            (sender, certificate, chain, sslPolicyErrors) => true);

        using (var channel = new Channel(url, channelCredentials))
        {
            await channel.ConnectAsync();
            var client = new Board.BoardClient(channel);
            var digitalRequest = new GetDigitalRequest() { PinName = "digital_out0" };

            // 后续添加签名元数据后再发起请求
            var response = await client.GetDigitalAsync(digitalRequest);
            Console.WriteLine("Get digital response received: " + response.Result);
        }
    }
}

2. 缺失签名验证所需的请求头 #

Python服务器的SignatureValidationInterceptor要求请求携带x-signature头，值为方法名的反转（例如GetDigital对应latigeDteG）。原C#客户端未添加该头，导致认证失败。

修复：
在请求中添加签名元数据，修改后的调用代码片段：

// 创建元数据并添加签名头
var metadata = new Metadata();
string methodName = "GetDigital";
metadata.Add("x-signature", new string(methodName.Reverse().ToArray()));

// 携带元数据发起请求
var response = await client.GetDigitalAsync(digitalRequest, metadata);

3. 自签名证书配置修正 #

原客户端将服务器证书添加到ClientCertificates是错误操作（该配置用于双向认证的客户端证书），改为通过SslCredentials加载服务器证书并处理验证逻辑。

额外注意事项 #

• 生产环境请勿跳过证书验证，需将自签名证书导入客户端信任根证书库。
• 若需在浏览器等场景使用gRPC Web，需在Python服务器前部署gRPC Web代理（如Envoy），或使用支持gRPC Web的Python服务器扩展。

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