C#怎么使用gRPC通信 .NET gRPC服务创建与调用方法

浅杰吖_9705

浅杰吖_9705

2026-01-11

929人浏览

原创

.net中使用grpc需定义.proto文件、生成代码、配置服务与客户端;注意http/2、tls、跨平台兼容性;服务端用dotnet new grpc创建,启用addgrpc()和mapgrpcservice();客户端通过grpcchannel调用,复用通道提升性能。

c#怎么使用grpc通信 .net grpc服务创建与调用方法

在.NET中使用gRPC通信,核心是定义Protocol Buffers(.proto)接口、生成客户端/服务端代码、配置gRPC服务与客户端。整个过程不复杂但容易忽略细节,比如HTTP/2支持、TLS配置或跨平台兼容性。

创建.NET gRPC服务端

使用.NET 6+ SDK可快速搭建gRPC服务:

  • 新建项目:运行 dotnet new grpc -n MyGrpcService
  • 项目默认包含 Protos/greet.proto 和 Services/GreeterService.cs,对应定义的gRPC服务和实现
  • 确保 Program.cs 中已启用gRPC:调用 builder.Services.AddGrpc() 和 app.MapGrpcService<greeterservice>()</greeterservice>
  • gRPC必须运行在HTTP/2上,默认Kestrel支持;若用IIS或反向代理(如Nginx),需确认已启用HTTP/2并正确转发

定义和更新.proto文件

所有通信契约由 .proto 文件统一描述,这是gRPC的源头:

Work Productivity Gog Google Workflow Helper
Work Productivity Gog Google Workflow Helper

帮助用户满足已验证的需求:代理用户在Clawhub上对Gog式工作流有强烈需求,需要实际帮助修复bug、强化设置等。

下载
  • 放在 Protos/ 目录下,例如 calculator.proto
  • 需声明 syntax = "proto3";,并用 option csharp_namespace 指定C#命名空间
  • 定义 service 时,方法默认为 unary(一发一收),也支持 server streaming、client streaming 和 bidirectional streaming
  • 修改 .proto 后,SDK会自动通过 dotnet-grpc 工具重新生成 C# 代码(需在项目文件中含 <protobuf ...></protobuf> 项)

从.NET客户端调用gRPC服务

客户端不需要手动处理HTTP/2或序列化,只需引用生成的类型并创建通道:

  • 添加 nuget 包:Grpc.Net.Client 和 Google.Protobuf(若未自动引入)
  • 用 GrpcChannel.ForAddress("https://localhost:5001") 创建安全通道(推荐HTTPS + TLS);开发时若用HTTP,需显式配置 AppContext.SetSwitch("System.Net.Http.SocketsHttpHandler.Http2UnencryptedSupport", true)
  • 通过 channel.CreateGrpcService<icalculatorservice>()</icalculatorservice> 获取强类型客户端(需引用服务端生成的 .cs 文件或独立的 Contracts 类库)
  • 直接调用方法,如 var response = await client.AddAsync(new AddRequest { A = 1, B = 2 });,底层自动序列化/反序列化

常见问题与建议

实际使用中几个关键点常被忽视:

  • 证书问题:本地开发用 dotnet dev-certs https --trust 安装自签名证书,否则gRPC over HTTPS会失败
  • 跨语言调用:只要对方按同一 .proto 实现,C#客户端可调用Go/Python/Rust等写的gRPC服务,反之亦然
  • 错误处理:gRPC异常统一为 RpcException,可通过 exception.Status.StatusCode 和 exception.Status.Detail 获取服务端返回的错误码和消息
  • 性能优化:避免在高频调用中反复创建 GrpcChannel,应复用单例通道;如需细粒度控制(如超时、压缩),可通过 ChannelOptions 配置

基本上就这些。掌握 proto 定义、服务注册、通道管理这三环,就能稳定构建和消费.NET gRPC服务。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++系统编程内存管理_C++系统编程怎么与Rust竞争内存安全
C++系统编程内存管理_C++系统编程怎么与Rust竞争内存安全

C++系统编程中的内存管理是指 对程序运行时内存的申请、使用和释放进行精细控制的机制,涵盖了栈、堆、静态区等不同区域,开发者需要通过new/delete、智能指针或内存池等方式管理动态内存,以避免内存泄漏、野指针等问题,确保程序高效稳定运行。它核心在于开发者对低层内存有完全控制权,带来灵活性,但也伴随高责任,是C++性能优化的关键。

2025.12.22

106

5

Rust异步编程与Tokio运行时实战
Rust异步编程与Tokio运行时实战

本专题聚焦 Rust 语言的异步编程模型,深入讲解 async/await 机制与 Tokio 运行时的核心原理。内容包括异步任务调度、Future 执行模型、并发安全、网络 IO 编程以及高并发场景下的性能优化。通过实战示例,帮助开发者使用 Rust 构建高性能、低延迟的后端服务与网络应用。

2026.02.11

258

16

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

2026.03.05

622

19

Rust 系统编程入门与实战
Rust 系统编程入门与实战

统讲解近年最受关注的系统级编程语言 Rust 的核心知识体系,涵盖 Rust 的安装与 Cargo 项目管理、变量绑定与不可变性设计哲学、所有权(Ownership)/ 借用(Borrowing)/ 生命周期(Lifetime)三大核心概念、结构体/枚举与模式匹配(match)、Trait 特征系统与泛型编程、错误处理(Result/Option)、智能指针(Box/Rc/Arc)、并发编程的无畏并发(Fearless Concurre

2026.05.29

477

21

Rust异步网络服务与Tokio Runtime深度实践
Rust异步网络服务与Tokio Runtime深度实践

本专题围绕 Rust 在高并发网络服务中的应用展开,系统讲解 Tokio 异步运行时、任务调度模型、Future 执行机制以及高性能网络编程方式。结合实际服务端案例,帮助开发者构建低延迟、高可靠的异步服务架构。

2026.06.29

276

13

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

403

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3747

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

6505

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

581

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习