Jackson如何在DTO中建模键灵活且值可为单值的列表映射？

方案1：用@JsonFormat注解直接配置字段 #

你可以在DTO的attributes字段上添加@JsonFormat注解，启用ACCEPT_SINGLE_VALUE_AS_ARRAY特性，Jackson会自动把单个字符串值包装成集合：

public class CharacterProfile {
    // 其他字段...
    @JsonFormat(features = JsonFormat.Feature.ACCEPT_SINGLE_VALUE_AS_ARRAY)
    private Map<String, Collection<String>> attributes;

    // getter/setter方法
}

这个注解虽然常被说明作用于Collection类型，但实际上能作用于以Collection为值的Map字段，Jackson会递归处理Map的value部分，将单个字符串转为单元素Collection。

方案2：全局配置ObjectMapper #

如果项目中有多个类似字段需要处理，可全局启用该特性，避免逐个字段加注解：

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);

这里用的是DeserializationFeature而非JsonFormat.Feature，全局启用后，所有接收Collection类型的场景都会自动把单个值转为集合，包括Map的value。

方案3：自定义反序列化器（复杂场景适用） #

如果需要处理空值、特定字符串转换等复杂逻辑，可以自定义针对Collection<String>的反序列化器，再绑定到Map的value上：

public class SingleOrArrayDeserializer extends JsonDeserializer<Collection<String>> {
    @Override
    public Collection<String> deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        Collection<String> result = new ArrayList<>();
        if (node.isArray()) {
            for (JsonNode item : node) {
                result.add(item.asText());
            }
        } else if (!node.isNull()) {
            result.add(node.asText());
        }
        return result;
    }
}

然后在DTO字段上指定该反序列化器：

public class CharacterProfile {
    // 其他字段...
    @JsonDeserialize(contentUsing = SingleOrArrayDeserializer.class)
    private Map<String, Collection<String>> attributes;

    // getter/setter方法
}

DTO设计建议 #

当前Map<String, Collection<String>>的设计完全合理，不需要调整。API返回的键是未知字符串，Map能适配这种动态结构；用Collection作为value可以统一处理单个值和数组的情况，完全匹配数据的实际形态。

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