Spring控制器@RequestBody映射无限属性JSON对象的解决方案

嘿，我之前在Spring项目里也碰到过类似的JSON映射问题，给你几个实用的解决方案，应该能帮你搞定：

有时候不是类型本身的问题，而是一些容易忽略的配置或请求细节导致失败，先检查这些点：

• 确保你的项目已经引入Jackson依赖（Spring Boot默认自带，普通Spring项目需要手动添加相关依赖）
• 发送请求时，一定要设置Content-Type为application/json，否则@RequestBody无法正确解析JSON
• 确认请求体里的所有值都是字符串类型，如果有数字、布尔值等非字符串内容，直接用HashMap<String,String>会解析失败，这时候可以参考后面的方案

如果这些都没问题，直接用HashMap<String,String>是完全可行的，示例代码如下：

@RestController
@RequestMapping("/demo")
public class JsonMappingController {

    @PostMapping("/parse")
    public ResponseEntity<String> parseJson(@RequestBody HashMap<String, String> jsonMap) {
        // 处理映射后的Map
        System.out.println("key_1的值：" + jsonMap.get("key_1"));
        return ResponseEntity.ok("JSON解析成功");
    }
}

如果你的JSON结构是固定的（比如明确有key_1、key_2这些字段），创建一个DTO（数据传输对象）会更规范，也更便于后续维护：

// 自定义DTO类
public class CustomJsonDTO {
    private String key_1;
    private String key_2;
    private String key_3;
    // 如有更多固定字段，继续添加

    // 生成getter和setter方法，也可以用Lombok的@Data注解简化代码
    public String getKey_1() {
        return key_1;
    }

    public void setKey_1(String key_1) {
        this.key_1 = key_1;
    }

    // 其他字段的getter/setter同理
}

然后在控制器中使用这个DTO：

@PostMapping("/parse-dto")
public ResponseEntity<String> parseJsonWithDto(@RequestBody CustomJsonDTO customDto) {
    System.out.println("key_1的值：" + customDto.getKey_1());
    return ResponseEntity.ok("DTO解析成功");
}

如果JSON里的值不都是字符串（比如包含数字、布尔值等），但你还是想统一接收所有字段，可以用Map<String, Object>，之后再根据需求转换类型：

@PostMapping("/parse-mixed")
public ResponseEntity<String> parseMixedJson(@RequestBody Map<String, Object> jsonMap) {
    // 将Object类型的值转为String
    String key1Value = String.valueOf(jsonMap.get("key_1"));
    // 处理其他字段
    return ResponseEntity.ok("混合类型JSON解析成功");
}

如果你的JSON字段是动态的（比如不确定有多少个key_N），可以创建一个类，通过@JsonAnySetter注解来接收所有动态字段：

public class DynamicJsonHolder {
    private Map<String, String> dynamicFields = new HashMap<>();

    // 所有未匹配到固定字段的键值对都会被这个方法处理
    @JsonAnySetter
    public void addField(String key, String value) {
        dynamicFields.put(key, value);
    }

    public Map<String, String> getDynamicFields() {
        return dynamicFields;
    }
}

控制器中使用这个类：

@PostMapping("/parse-dynamic")
public ResponseEntity<String> parseDynamicJson(@RequestBody DynamicJsonHolder holder) {
    Map<String, String> jsonMap = holder.getDynamicFields();
    // 处理动态字段
    jsonMap.forEach((key, value) -> System.out.println(key + ": " + value));
    return ResponseEntity.ok("动态字段JSON解析成功");
}

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