遗留Spring Boot API转Protobuf：JSON数组反序列化与兼容方案问询

Proto 定义 #

message Course {
  int32 id = 1;
  string course_name = 2;
}

遗留 Spring Boot Controller（需保持向后兼容） #

@RestController
public class CourseController {
  @Autowired
  CourseRepository courseRepo;

  @RequestMapping("/courses/{id}")
  Course customer(@PathVariable Integer id) {
    return courseRepo.getCourse(id);
  }

  @PostMapping("/courses")
  Course post(@RequestBody Course course) {
    courseRepo.add(course);
    return course;
  }

  @PostMapping("/courses-bulk")
  Collection<Course> bulk(@RequestBody List<Course> courses) {
    for (Course c : courses) {
      courseRepo.add(c);
    }
    return courseRepo.getAll();
  }
}

已配置的 Bean #

@Bean
ProtobufHttpMessageConverter protobufHttpMessageConverter() {
  return new ProtobufHttpMessageConverter();
}

遇到的错误 #

Caused by: com.fasterxml.jackson.databind.exc.InvalidDefinitionException:
Cannot find a (Map) Key deserializer for type [simple type, class com.google.protobuf.Descriptors$FieldDescriptor]

问题 #

1. ProtobufHttpMessageConverter 是否支持反序列化 JSON 数组？
2. 若不支持，如何让 Jackson 适配 Protobuf POJO，使其在 ProtobufHttpMessageConverter 无法处理 JSON 数组负载时作为回退方案？

问题1：ProtobufHttpMessageConverter 是否支持反序列化 JSON 数组？ #

不支持。ProtobufHttpMessageConverter 核心用于处理单个 Protobuf 消息的序列化/反序列化——不管是二进制 Protobuf 格式还是对应的 JSON 格式，它都只针对单个消息实例做处理，无法直接解析 JSON 数组（即多个 Protobuf 消息的集合）。这也是你的 /courses-bulk 接口触发 Jackson 作为 fallback 的原因，因为转换器无法处理数组类型的请求体。

问题2：让 Jackson 适配 Protobuf POJO 作为回退方案 #

可以通过引入 Jackson 的 Protobuf 模块解决问题，步骤如下：

1. 添加依赖
   如果用 Maven，在 pom.xml 中添加：

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-protobuf</artifactId>
</dependency>

如果用 Gradle：

implementation 'com.fasterxml.jackson.dataformat:jackson-dataformat-protobuf'

2. 注册 Protobuf 模块到 Jackson
   将 Jackson 的 Protobuf 模块配置到 Spring 的 ObjectMapper 中，让 Jackson 能正确序列化/反序列化 Protobuf 生成的 POJO（包括集合类型）。可以通过自定义 Jackson2ObjectMapperBuilder Bean 实现：

@Bean
public Jackson2ObjectMapperBuilder jackson2ObjectMapperBuilder() {
    Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder();
    builder.modules(new ProtobufModule());
    return builder;
}

3. 调整消息转换器顺序（可选）
   如果希望优先用 ProtobufHttpMessageConverter 处理单个消息，仅当它无法处理时（比如数组）才让 Jackson 接手，可以调整转换器优先级——设置它的 order 为比 Jackson 转换器更高的优先级（数值越小优先级越高）：

@Bean
ProtobufHttpMessageConverter protobufHttpMessageConverter() {
    ProtobufHttpMessageConverter converter = new ProtobufHttpMessageConverter();
    converter.setOrder(Ordered.HIGHEST_PRECEDENCE);
    return converter;
}

配置完成后，单个 Protobuf 消息的请求/响应会由 ProtobufHttpMessageConverter 处理，JSON 数组这类它不支持的场景会自动回退到配置了 Protobuf 模块的 Jackson 处理，避免解析错误。

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