Jackson反序列化Proto生成类列表报错：找不到Map Key反序列化器

你遇到的InvalidDefinitionException是因为Jackson默认不支持将JSON字符串直接反序列化为com.google.protobuf.Descriptors$FieldDescriptor类型的Map键——FieldDescriptor是Protobuf用于描述字段的内部类型，没有内置的Jackson键反序列化逻辑。下面提供两种可行的解决方案：

方案1：自定义Jackson键反序列化器 #

直接给FieldDescriptor类型的Map键编写反序列化逻辑，让Jackson知道如何将JSON中的字符串键转换为FieldDescriptor实例：

1. 实现KeyDeserializer类：

import com.fasterxml.jackson.databind.KeyDeserializer;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.google.protobuf.Descriptors;
import java.io.IOException;

public class FieldDescriptorKeyDeserializer extends KeyDeserializer {
    private final Descriptors.Descriptor targetProtoDescriptor;

    // 传入对应Proto的描述符，比如SnmpV3User.getDescriptor()
    public FieldDescriptorKeyDeserializer(Descriptors.Descriptor targetProtoDescriptor) {
        this.targetProtoDescriptor = targetProtoDescriptor;
    }

    @Override
    public Object deserializeKey(String key, DeserializationContext ctxt) throws IOException {
        Descriptors.FieldDescriptor fieldDescriptor = targetProtoDescriptor.findFieldByName(key);
        if (fieldDescriptor == null) {
            throw new IOException("无法找到Proto字段: " + key);
        }
        return fieldDescriptor;
    }
}

2. 给TrapConfigBean中的Map字段添加注解，指定使用这个自定义反序列化器：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.google.protobuf.Descriptors;
import java.util.Map;

public class TrapConfigBean {
    @JsonDeserialize(keyUsing = FieldDescriptorKeyDeserializer.class)
    private Map<Descriptors.FieldDescriptor, SnmpV3User> snmpV3Users;

    // 其他字段、getter、setter方法
}

3. 若需要动态适配不同的Proto描述符，可以通过Jackson模块注册反序列化器，替代注解方式：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.google.protobuf.Descriptors;

// 初始化ObjectMapper并注册模块
SimpleModule protoKeyModule = new SimpleModule();
protoKeyModule.addKeyDeserializer(Descriptors.FieldDescriptor.class, 
    new FieldDescriptorKeyDeserializer(SnmpV3User.getDescriptor()));

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.registerModule(protoKeyModule);

方案2：先转字符串Map再业务转换 #

如果不想编写自定义序列化器，可以先将JSON反序列化为Map<String, SnmpV3User>，再在业务代码中手动转换为以FieldDescriptor为键的Map：

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.google.protobuf.Descriptors;
import java.util.HashMap;
import java.util.Map;

// 1. 先反序列化为字符串键的Map
ObjectMapper objectMapper = new ObjectMapper();
Map<String, SnmpV3User> stringKeyMap = objectMapper.readValue(
    jsonContent, 
    new TypeReference<Map<String, SnmpV3User>>() {}
);

// 2. 转换为FieldDescriptor为键的Map
Descriptors.Descriptor userDescriptor = SnmpV3User.getDescriptor();
Map<Descriptors.FieldDescriptor, SnmpV3User> targetMap = new HashMap<>();
for (Map.Entry<String, SnmpV3User> entry : stringKeyMap.entrySet()) {
    Descriptors.FieldDescriptor fd = userDescriptor.findFieldByName(entry.getKey());
    if (fd != null) {
        targetMap.put(fd, entry.getValue());
    }
}

// 3. 赋值给TrapConfigBean
TrapConfigBean config = new TrapConfigBean();
config.setSnmpV3Users(targetMap);

注意事项 #

• 两种方案都要求JSON中的键名和Proto定义的字段名完全匹配（区分大小写）
• 若你的场景涉及多种不同的FieldDescriptor类型，需要为每种类型单独处理反序列化逻辑

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