0

0

C# gRPC双向流方法 C#如何实现客户端和服务器的实时双向通信

星降

星降

发布时间:2026-02-05 05:19:08

|

309人浏览过

|

来源于php中文网

原创

gRPC双向流在C#中对应方法签名是public async Task BidirectionalStreaming(IAsyncEnumerable requestStream, IServerStreamWriter responseStream, ServerCallContext context);客户端必须用CallAsync()调用,且proto需声明rpc Chat(stream Message) returns (stream Message)。

c# grpc双向流方法 c#如何实现客户端和服务器的实时双向通信

gRPC 双向流在 C# 中对应什么方法签名

双向流(Bidi Streaming)在 C# gRPC 中必须使用 IAsyncEnumerable 作为参数,返回 IAsyncEnumerable。不能用普通 Task 或单次 ValueTask,否则编译通过但运行时会报错 Status(StatusCode=Unimplemented, Detail="Method not found")

服务端方法签名必须是 public async Task BidirectionalStreaming(IAsyncEnumerable requestStream, IServerStreamWriter responseStream, ServerCallContext context) 或更常见的异步迭代写法(见下条):

  • 客户端调用必须用 CallAsync() 而非 AsyncUnaryCall 等其他方式
  • proto 文件中该 RPC 必须声明为 rpc Chat(stream Message) returns (stream Message); —— 两个 stream 缺一不可
  • 生成的客户端类里对应方法名后缀是 Async,且参数/返回类型严格匹配生成器输出(如 ChatAsync

客户端如何正确发送+接收并避免挂起或丢消息

常见错误是只 await foreach 接收,却没主动发请求;或用 Channel 发送但未调用 Writer.CompleteAsync() 导致服务端永远等不到流结束信号。

推荐结构:用 Channel 做发送缓冲,同时启动两个并发任务(发送 + 接收),并在退出前显式关闭发送通道:

var channel = Channel.CreateUnbounded();
using var call = client.ChatAsync();
_ = Task.Run(async () =>
{
    await foreach (var req in channel.Reader.ReadAllAsync())
    {
        await call.RequestStream.WriteAsync(req);
    }
    await call.RequestStream.CompleteAsync(); // 关键:通知服务端“我不再发了”
});
// 启动接收
_ = Task.Run(async () =>
{
    await foreach (var resp in call.ResponseStream.ReadAllAsync())
    {
        Console.WriteLine(resp.Content);
    }
});
// 示例:发一条消息
await channel.Writer.WriteAsync(new Request { Content = "hello" });

注意:call.ResponseStream.ReadAllAsync() 是 .NET 6+ 才支持的扩展方法;若用 .NET 5,需手动 while (await call.ResponseStream.MoveNext())

笔灵AI论文写作
笔灵AI论文写作

免费生成毕业论文、课题论文、千字大纲,几万字专业初稿!

下载

服务端如何维持长连接并处理并发客户端

双向流默认不超时,但底层 HTTP/2 连接可能被代理或防火墙中断。必须在 ServerCallContext 中监听取消令牌,并在异常时及时释放资源。

  • 不要在流处理中直接 await Task.Delay 阻塞循环,应改用 context.CancellationToken 控制等待
  • 每个客户端连接对应一个独立的流处理任务,天然并发;但共享状态(如全局广播列表)需加锁或用 ConcurrentDictionary
  • 若需广播消息给所有活跃客户端,建议把 IServerStreamWriter 存入线程安全集合,并在写入前检查 context.CancellationToken.IsCancellationRequested
  • 服务端抛出异常(如 throw new RpcException(new Status(StatusCode.Cancelled, "bye")))会立即断开该流,客户端收到 RpcException 并可捕获 Status.StatusCode

调试时最常见的三个失败点

90% 的双向流不通问题集中在这三处:

  • proto 定义漏掉任一 stream 关键字 → 生成代码变成 unary 方法,客户端调用时 404
  • 客户端未调用 CompleteAsync() → 服务端 await foreach 永远卡住,无任何日志
  • 服务端未响应任何 WriteAsync() → 客户端 ResponseStream 不触发 MoveNext,看起来像“连上了但没反应”

最有效的验证方式:先注释掉所有业务逻辑,在服务端流开始时立刻 await responseStream.WriteAsync(new Response { ... }),客户端打印收到内容;确认基础通路跑通后再加逻辑。HTTP/2 层面的问题(如 TLS 配置、ALPN 协商失败)通常表现为 IOException: The request was aborted,此时需查 Kestrel 日志而非业务代码。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
while的用法
while的用法

while的用法是“while 条件: 代码块”,条件是一个表达式,当条件为真时,执行代码块,然后再次判断条件是否为真,如果为真则继续执行代码块,直到条件为假为止。本专题为大家提供while相关的文章、下载、课程内容,供大家免费下载体验。

98

2023.09.25

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

119

2025.12.04

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

589

2023.08.10

Golang channel原理
Golang channel原理

本专题整合了Golang channel通信相关介绍,阅读专题下面的文章了解更多详细内容。

249

2025.11.14

golang channel相关教程
golang channel相关教程

本专题整合了golang处理channel相关教程,阅读专题下面的文章了解更多详细内容。

344

2025.11.17

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

440

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

424

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

2590

2024.03.12

抖音网页版入口与视频观看指南 抖音官网视频在线访问
抖音网页版入口与视频观看指南 抖音官网视频在线访问

本专题汇总了抖音网页版的入口链接、官方登录页面以及视频观看入口,帮助用户快速访问抖音网页版,提供免登录访问方式和直接进入视频播放页面的方法,确保顺利浏览和观看抖音视频。

61

2026.02.04

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Linux网络安全之防火墙技术汇总
Linux网络安全之防火墙技术汇总

共31课时 | 3.1万人学习

10分钟--Midjourney创作自己的漫画
10分钟--Midjourney创作自己的漫画

共1课时 | 0.1万人学习

Midjourney 关键词系列整合
Midjourney 关键词系列整合

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号