Spring Boot中如何返回包含重复键的JSON对象？

你遇到的问题核心是Java的Map（比如HashMap）不允许重复键，所以用Map构建数据时，后put的"sku"会直接覆盖之前的值，自然生成的JSON也只有最后一个条目。要生成带重复键的JSON，得绕过Map的限制，可采用以下两种方案：

方案1：直接返回构造好的JSON字符串 #

这种方式最简单，直接手动拼接符合要求的JSON内容，返回String类型即可，记得指定响应的Content-Type为application/json：

@GetMapping("/{id}")
public ResponseEntity<String> getProduct(@PathVariable String id) {
    String json = "{\"id\":\"1401\",\"sku\":\"C18-25\",\"sku\":\"A15-70\"}";
    return ResponseEntity.ok()
            .contentType(MediaType.APPLICATION_JSON)
            .body(json);
}

方案2：用Jackson的ObjectNode手动构建（推荐） #

Spring Boot默认使用Jackson作为JSON处理库，它的ObjectNode类支持添加重复键（底层用列表存储键值对，而非Map），可以灵活构建你需要的JSON结构：

首先确保引入Jackson依赖（Spring Boot web starter默认已包含），然后修改代码：

import com.fasterxml.jackson.databind.node.ObjectNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ProductController {

    private final ObjectMapper objectMapper;

    // 注入Spring Boot自动配置的ObjectMapper
    public ProductController(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @GetMapping("/{id}")
    public ResponseEntity<ObjectNode> getProduct(@PathVariable String id) {
        ObjectNode jsonNode = objectMapper.createObjectNode();
        jsonNode.put("id", "1401");
        // 重复调用put添加同名键
        jsonNode.put("sku", "C18-25");
        jsonNode.put("sku", "A15-70");
        
        return ResponseEntity.ok(jsonNode);
    }
}

重要注意事项 #

虽然ECMA-404规范允许JSON存在重复键，但大部分JSON解析库（包括前端的JSON.parse）在解析这种结构时，会自动保留最后一个键值对、覆盖前面的。所以在实现前，务必确认你的客户端（调用方）能够正确处理带重复键的JSON，否则可能出现数据丢失的问题。

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