proto3如何定义必填字段 强制PHP调用方显式赋值禁用自动默认值

proto3默认移除了proto2的required修饰符，所有普通字段都会自动填充类型默认值，且原生无法判断是否被用户主动赋值，要实现强制显式赋值可参考以下方案：

方案1：使用proto3.12+版本的optional修饰符（最推荐） #

这是官方原生支持的字段存在性检测能力，开启后可以明确区分「用户未传字段」和「用户主动传了默认值」两种场景：

1. 修改proto文件配置，给需要校验的字段添加optional修饰符：

syntax = "proto3";
// 3.12~3.16版本需要加此行开启可选字段支持，3.17+版本默认支持可省略
option optional_field_presence = true;

package message.events.user.v1;

message UserWasActivatedMessage {
  optional int32 userId = 1 ;
  optional string eventType = 2;
}

2. 在PHP业务代码中增加校验逻辑，序列化消息前调用生成类自带的hasXXX()方法判断字段是否被主动赋值：

$message = new UserWasActivatedMessage();
// 业务赋值逻辑...

// 强制校验字段存在性
if (!$message->hasUserId()) {
    throw new \InvalidArgumentException('userId必须显式赋值');
}
if (!$message->hasEventType()) {
    throw new \InvalidArgumentException('eventType必须显式赋值');
}

// 后续序列化、发送逻辑

接收侧也可以用同样的方法校验调用方是否传了必填字段。

方案2：自定义全局校验层（兼容低版本proto3） #

如果暂时无法升级protoc到3.12以上版本，可以在PHP侧统一封装消息校验逻辑：

• 提前为每个message定义必填字段列表和校验规则，存入配置数组
• 封装统一的消息发送/接收入口，通过反射或者proto生成类的getXXX()方法做校验，比如要求userId必须大于0、eventType不能为空字符串

该方案存在局限性：如果用户主动传了和默认值相同的有效值，会被误判为未赋值，仅适合字段有效值和默认值完全不重叠的业务场景

方案3：使用protobuf校验插件 #

可以使用protoc-gen-validate这类protoc校验插件，在proto文件中直接定义字段校验规则，生成代码时会自动生成对应的校验方法：

syntax = "proto3";
package message.events.user.v1;
import "validate/validate.proto";

message UserWasActivatedMessage {
  int32 userId = 1 [(validate.rules).int32.gt = 0];
  string eventType = 2 [(validate.rules).string.min_len = 1];
}

生成PHP代码后直接调用自动生成的validate()方法即可自动完成字段校验，不符合规则会直接抛出异常。

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