c# gprc入门教程_技术教程_雄杰鑫电商资讯网

gRPC在C#中需严格遵循.proto契约驱动流程：先正确编写greet.proto，再通过项和Grpc.Tools生成C#类，确保csharp_namespace一致；接着继承GreeterBase并override SayHello方法；最后注册服务、配置客户端连接及可选命名管道。

gRPC 在 C# 中不是“装完包就能跑”的框架，它依赖严格的契约驱动流程——.proto 文件必须先写对、再生成、再实现，三者错一步，编译或运行时就会报错。下面直奔实操要点。

怎么让 `greet.proto` 正确生成 C# 类？

生成失败是新手第一道坎，常见现象：GreeterBase 找不到、HelloRequest 类型不存在、编译提

示 “The type or namespace name 'Grpc' could not be found”。根本原因通常是 .proto 文件没被正确纳入构建流程。

确保项目文件（.csproj）中包含项，且路径准确：
```
  
```
Grpc.Tools 必须安装（服务端和客户端都要），它不参与发布，只在构建时调用 protoc；Grpc.AspNetCore（服务端）和 Grpc.Net.Client（客户端）才是运行时依赖
option csharp_namespace 必须与项目实际命名空间一致，否则生成的类会落在错误命名空间下，引用时找不到

为什么 `SayHello` 方法总返回 `UNIMPLEMENTED`？

因为 GreeterBase 是抽象基类，自动生成的默认实现直接抛出 RpcException。你必须提供具体子类并重写方法，否则任何客户端调用都会收到状态码 StatusCode.Unimplemented。

实现类必须继承 GreeterBase，且用 override 显式重写方法
返回值必须是 Task，不能用 async/await 却忘了 return，也不能返回 null
注册服务时，必须在 Program.cs 中调用：
```
app.MapGrpcService();
```

客户端连不上服务器？检查这三点

典型错误：客户端抛出 Status(StatusCode=Unavailable, Detail="failed to connect to all addresses")。这不是代码逻辑问题，而是通信链路未打通。

确认服务器监听的是 http://localhost:5001（或你配置的地址），且没有被防火墙/杀软拦截
客户端创建 Channel 时，地址协议必须是 http://（开发阶段）或 https://（生产启用 TLS 后），不能漏掉协议头
若用 .NET 8+ + Kestrel 默认 HTTPS 模式，而客户端仍连 http://，会因 HTTP/2 不兼容直接拒绝连接——要么改客户端为 https:// 并信任证书，要么在服务器禁用 HTTPS 重定向（仅限开发）

命名管道（IPC）能用 `gRPC` 吗？

可以，但仅限 Windows，且必须显式配置 Kestrel 使用命名管道终结点。这是绕过网络栈、提升本地进程间通信性能的有效方式，但容易被忽略。

服务器端需在 Program.cs 中配置：

builder.WebHost.ConfigureKestrel(serverOptions =>
{
    serverOptions.ListenNamedPipe("MyPipeName", listenOptions =>
    {
        listenOptions.Protocols = HttpProtocols.Http2;
    });
});