讲师中心 微信公众号
AI工具推荐 视频效率加速

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

雨瑶吖_3786

雨瑶吖_3786

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

|

409人浏览过

|

来源于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<trequest></trequest> 作为参数,返回 IAsyncEnumerable<tresponse></tresponse>。不能用普通 Task 或单次 ValueTask<t></t>,否则编译通过但运行时会报错 Status(StatusCode=Unimplemented, Detail="Method not found")。

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

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

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

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

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

Livestream Script Generator
Livestream Script Generator

直播带货脚本:话术、节奏、互动、促单。适用于主播、电商运营、MCN机构。

下载
var channel = Channel.CreateUnbounded<Request>();
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())。

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

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

  • 不要在流处理中直接 await Task.Delay 阻塞循环,应改用 context.CancellationToken 控制等待
  • 每个客户端连接对应一个独立的流处理任务,天然并发;但共享状态(如全局广播列表)需加锁或用 ConcurrentDictionary
  • 若需广播消息给所有活跃客户端,建议把 IServerStreamWriter<response></response> 存入线程安全集合,并在写入前检查 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大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
while的用法
while的用法

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

354

2023.09.25

php中foreach用法
php中foreach用法

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

818

2025.12.04

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

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

4678

2023.08.10

Golang channel原理
Golang channel原理

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

454

2025.11.14

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

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

639

2025.11.17

Go语言 channel用法详解
Go语言 channel用法详解

本专题整合了go语言中channel的各种使用方法,阅读专题下面的文章了解更多详细步骤。

503

2026.04.03

http500解决方法
http500解决方法

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

3923

2023.11.09

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

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

974

2023.11.14

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn