Protobuf序列化SUCCESS枚举为空字节数组致Spring Boot接口400求助

一、跨语言序列化差异原因 #

Protobuf 3规范中，默认值字段不会被序列化，proto3里枚举的默认值是第一个定义的枚举值（即SUCCESS=0）。Java的Protobuf实现严格遵循这个规则，所以当statusCode为SUCCESS时，不会写入任何字节，生成空数组。

而Python/C++的Protobuf实现存在版本或配置差异：部分版本的库允许显式序列化默认值字段，或者在特定配置下会强制写入默认值，因此会生成{8,0}（8是字段1的wire type编码，0是SUCCESS的数值）。

二、解决Spring Boot请求问题及区分请求的方案 #

1. 自定义序列化逻辑，强制写入默认值 #

绕过生成代码的判断，手动用CodedOutputStream写入字段：

StatusOuterClass.Status s = StatusOuterClass.Status.newBuilder()
        .setStatusCode(StatusOuterClass.Status.StatusCodeType.SUCCESS)
        .build();

ByteArrayOutputStream baos = new ByteArrayOutputStream();
CodedOutputStream output = CodedOutputStream.newInstance(baos);
// 强制写入枚举字段，忽略默认值判断
output.writeEnum(1, s.getStatusCode().getNumber());
s.getUnknownFields().writeTo(output);
output.flush();
byte[] bytes = baos.toByteArray(); // 此时bytes为{8,0}

2. 修改Spring Boot的请求解析逻辑 #

自定义ProtobufHttpMessageConverter，处理空字节数组并解析为默认Status对象：

@Configuration
public class ProtobufConfig {
    @Bean
    public ProtobufHttpMessageConverter protobufHttpMessageConverter() {
        return new ProtobufHttpMessageConverter() {
            @Override
            protected Object readInternal(Class<?> clazz, HttpInputMessage inputMessage)
                    throws IOException, HttpMessageNotReadableException {
                InputStream inputStream = inputMessage.getBody();
                // 空字节数组且目标类型为Status时，返回默认的SUCCESS实例
                if (inputStream.available() == 0 && StatusOuterClass.Status.class.isAssignableFrom(clazz)) {
                    return StatusOuterClass.Status.getDefaultInstance();
                }
                return super.readInternal(clazz, inputMessage);
            }
        };
    }
}

这样控制器可区分两种情况：未发送请求体时，若控制器方法设置@RequestBody(required=true)会返回400；空字节数组则会被解析为SUCCESS的Status对象。

3. 使用包装消息（若允许调整API契约） #

如果可以修改API的请求结构，用包装消息包裹Status：

message StatusRequest {
  Status status = 1;
}

此时即使Status是空序列化，包装消息的字段标识会被写入，不会产生空字节数组，Spring Boot可正常解析，同时能明确区分是否发送了请求体。

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