SpringBoot类型转换异常：String转Map失败，请求协助解决

问题根源 #

后端抛出的String转Map异常，本质是前端发送的JSON数据格式和后端DTO期望的结构不匹配，常见场景：

• 前端某个本该是嵌套JSON对象（对应后端Map）的字段，被转成了JSON字符串存成了String值
• 前后端DTO的同名字段类型不一致（比如前端是String，后端是Map）
• 请求没正确设置Content-Type: application/json，导致后端解析错误

分步解决 #

1. 对齐前后端DTO字段类型 #

检查前端JavaFX的Ordinazione类，确保对应后端Map的字段类型是Map（比如ObservableMap或普通HashMap），而非String：

// 前端DTO示例
public class Ordinazione {
    private Map<String, Integer> dishQuantities; // 和后端字段类型保持一致
    // 其他字段、getter/setter
}

后端SpringBoot的DTO也要保持类型一致：

// 后端DTO示例
public class OrdinazioneDTO {
    private Map<String, Integer> dishQuantities;
    // 其他字段、getter/setter
}

2. 修正Unirest请求写法 #

发送请求时，直接传入DTO对象，让Unirest自动序列化，同时必须设置Content-Type：

// 前端正确请求示例
Ordinazione order = new Ordinazione();
// 填充订单数据，比如order.setDishQuantities(new HashMap<>(){{put("pizza",2);}});

HttpResponse<String> response = Unirest.post("http://你的后端地址/api/orders")
        .header("Content-Type", "application/json")
        .body(order) // 直接传对象，不要手动转成字符串再传
        .asString();

别做这种错误操作：把DTO序列化为字符串后再放到body里，这会导致后端收到的是嵌套字符串而非JSON对象。

3. 后端Controller注解检查 #

确保接收参数时用@RequestBody，让Spring自动解析JSON到DTO：

@RestController
@RequestMapping("/api/orders")
public class OrderController {
    @PostMapping
    public ResponseEntity<OrdinazioneDTO> createOrder(@RequestBody OrdinazioneDTO order) {
        // 业务逻辑
        return ResponseEntity.ok(order);
    }
}

4. 调试排查 #

• 前端打印序列化后的JSON：用new ObjectMapper().writeValueAsString(order)输出，检查对应Map字段是不是嵌套对象，而非字符串
• 后端打印原始请求体：临时把Controller参数改成@RequestBody String rawBody，输出日志看收到的JSON结构是否符合预期

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