Java Protobuf3中buildPartial方法的作用及适用场景是什么

关于buildPartial()的定位 #

这个API确实是proto2时期的遗留设计，最初就是为了配合proto2的required字段规则设计的。官方没有将其标记为废弃，是因为即使在proto3普及的当下，它仍然有不可替代的适用场景。

官方对该方法的定义是：

与MessageLite.Builder.build()类似，但如果消息缺少必填字段时不会抛出异常，而是返回一个部分构造的消息

适用场景 #

• 排障调试场景：当你构造消息时反复触发必填字段缺失异常时，可以调用buildPartial()生成半构造的消息，直接打印查看已填充的字段内容，快速定位漏填的必填字段，省去逐行排查代码的成本。
• 无校验的中间处理场景：如果你只是做消息的中转、格式转换、字段裁剪等中间操作，不需要消费消息的完整内容，也不需要保证消息最终合法性，用buildPartial()可以跳过不必要的字段校验，避免无关异常打断处理流程。这种情况在proto2、proto3混合维护的存量项目中非常常见。
• 容错降级场景：如果业务允许非核心必填字段缺失，不想因为字段不全导致整个主流程失败，可以用buildPartial()先构造可用的不完整消息，优先保证主流程可用，后续再通过告警、补传逻辑处理字段缺失的问题。
• 自定义校验规则场景：部分项目会通过protoc扩展插件给proto3字段增加自定义的必填校验逻辑，这种情况下build()仍然会触发校验抛出异常，buildPartial()同样可以用来跳过自定义校验，满足特殊场景的需求。

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