C#开发gRPC服务时如何在响应中正确传递数组数据

一、repeated字段直接赋值方法（无需流） #

你在proto里用repeated string定义的字段，本身就是设计用来传递列表/数组类型数据的，普通一元RPC调用完全不需要使用流，直接赋值即可。
C#的protobuf代码生成器会把repeated字段映射为RepeatedField<T>类型，这个类型默认在消息对象实例化时就已经初始化，不会为null，不需要手动new。
赋值有两种常用写法：

1. 已有现成数组/List数据源时，用AddRange批量添加：

public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
{
   // 假设myArray是你提前准备好的字符串数组：string[] myArray = ...;
   var reply = new HelloReply();
   reply.Message.AddRange(myArray); // 直接批量导入所有数组元素
   return Task.FromResult(reply);
}

2. 固定内容直接用集合初始化器写法：

public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
{
   return Task.FromResult(new HelloReply
   {
      // 直接在大括号内写元素即可，不需要手动new RepeatedField<string>
      Message = { "第一条响应内容", "第二条响应内容", "第三条响应内容" }
   });
}

二、什么时候需要用流？流的实现方式 #

只有满足以下场景时才需要用服务端流：

• 待返回的数据量极大，单次序列化会超出gRPC默认的消息大小限制
• 数据是动态生成的，不需要等所有数据准备好就可以逐块推送给客户端
• 需要实现服务端主动推送的实时效果

使用流首先要修改proto定义，在返回值前加stream关键字：

service Greeter {
  // 服务端流RPC：一次请求，服务端分多次返回响应
  rpc SayHello(HelloRequest) returns (stream HelloReply);
}

对应的C#服务端实现不需要返回单个Task<HelloReply>，而是通过IServerStreamWriter逐次写入响应：

public override async Task SayHello(HelloRequest request, IServerStreamWriter<HelloReply> responseStream, ServerCallContext context)
{
   // 遍历你的数组数据源
   foreach (var item in myArray)
   {
      // 逐条写入响应流，客户端不需要等所有内容处理完就能收到已发送的数据
      await responseStream.WriteAsync(new HelloReply
      {
         Message = { item }
      });
      // 可以根据业务需要加延迟、做数据生成逻辑，不需要提前准备好所有数据
   }
}

普通固定长度数组的返回场景，直接用第一部分的repeated字段赋值即可，逻辑和WCF返回字符串数组的体验一致，不需要额外封装。

三、C#版gRPC学习资料推荐 #

• 微软ASP.NET Core官方文档中的gRPC章节，所有示例均为C#实现，覆盖字段映射、四种RPC模式、错误处理、性能优化等全场景内容，是最贴合C#开发的参考
• 《gRPC实战》一书包含多语言实现示例，其中C#部分的基础用法、生产落地实践讲解比较细致
• .NET官方仓库的gRPC示例项目，包含所有基础场景的可直接运行的代码，可以直接对照参考

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