如何在Protobuf 3中定义可空（nullable）的repeated字段？

在Protobuf 3里，optional关键字对repeated字段无效，我们无法直接通过原生语法区分一个repeated字段是从未被设置过，还是被显式设置为空数组（对应Java中null和new String[0]的差异）。比如下面的定义：

message Result {
  repeated string url = 1;
}

Protobuf将这种“区分字段是否被设置”的需求称为字段存在性（Field Presence），但目前原生语法不支持直接为repeated字段实现这一点。另外，oneof语法也不能直接包含repeated字段，官方明确说明：

你可以向oneof定义中添加任意类型的字段，但不包括map字段和repeated字段。

针对这个问题，有两种常用的解决方案：

方案一：用嵌套消息包装repeated字段 #

把repeated字段封装到一个独立的嵌套消息中，然后用optional修饰这个嵌套消息字段。这样就能通过嵌套消息的存在性，区分原repeated字段的状态：

// 定义嵌套消息包装repeated字段
message UrlList {
  repeated string url = 1;
}

message Result {
  // optional修饰嵌套消息，区分未设置和已设置（包括空数组）
  optional UrlList urls = 1;
}

在Java中：

• 如果urls为null，说明原repeated字段从未被设置过；
• 如果urls不为null，但urls.getUrlList()是空列表，说明原repeated字段被显式设置为空数组。

这种方式是最可靠的，完全符合Protobuf的设计规范，不会出现状态不一致的问题。

方案二：添加布尔标记字段 #

额外新增一个布尔字段，用来标记repeated字段是否被设置过：

message Result {
  repeated string url = 1;
  // 标记url字段是否被显式设置过
  bool urls_set = 2;
}

使用时需要业务代码严格维护这个标记：

• 当首次设置url字段（包括设置为空数组）时，必须将urls_set设为true；
• 只有当url字段从未被操作过时，urls_set保持默认的false。

这种方式的缺点是依赖业务代码的规范性，容易出现标记与实际字段状态不一致的情况，仅适合简单场景。

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