Spring Boot中JSON与Java类不同字段名的映射解析问题

方案一：用@JsonProperty指定字段映射（推荐） #

这是最直接高效的方式，尤其适合大载荷场景。只需要在Java类的字段上，给@JsonProperty注解传入对应的JSON字段名即可，既不用修改原有类的命名规范，也无需改动JSON结构。

修改后的Java类示例：

import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.UUID;

public class MyClass {
    @JsonProperty("randomdstring-fieldId")
    private UUID id;
    
    @JsonProperty("anotherrandomstring-name")
    private String name;

    // 常规getter/setter即可，无需@JsonAnyGetter/Setter（这两个注解用于处理未知字段）
    public UUID getId() {
        return this.id;
    }

    public void setId(UUID id) {
        this.id = id;
    }

    public String getName() {
        return this.name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

解析代码和之前一致，ObjectMapper会自动按注解指定的映射关系完成解析：

ObjectMapper objectMapper = new ObjectMapper();
// 启用UUID自动解析，避免类型转换报错
objectMapper.registerModule(new JavaTimeModule());
MyClass customer = objectMapper.readValue(jsonString, MyClass.class);

方案二：解析为键值对手动赋值 #

如果需要自定义解析逻辑（比如字段名有统一规律可批量处理），可以先把JSON解析成Map<String, Object>，再手动提取值赋值给Java对象。

示例代码：

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
import java.util.UUID;

public class JsonParseDemo {
    public static void main(String[] args) throws Exception {
        String jsonString = "{\"randomdstring-fieldId\": \"xyz\", \"anotherrandomstring-name\": \"some name\"}";
        ObjectMapper objectMapper = new ObjectMapper();
        
        // 解析为键值对结构
        Map<String, Object> jsonMap = objectMapper.readValue(jsonString, Map.class);
        
        // 手动赋值给符合规范的Java类对象
        MyClass customer = new MyClass();
        customer.setId(UUID.fromString((String) jsonMap.get("randomdstring-fieldId")));
        customer.setName((String) jsonMap.get("anotherrandomstring-name"));
    }
}

// 这里的MyClass完全遵循团队命名规范，无需添加JsonProperty注解
class MyClass {
    private UUID id;
    private String name;

    // getter/setter省略
    public UUID getId() { return id; }
    public void setId(UUID id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
}

注意：超大载荷场景下手动赋值会比较繁琐，优先选方案一；如果字段名有固定规则（比如统一前缀+规范字段名），还可以自定义Jackson命名策略批量处理，但对新手而言，方案一足以应对大部分场景。

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