在 spring boot rest 接口中接收 map 类型参数，最稳妥的方式是使用 @requestbody 配合 json 格式提交数据。这种方式要求前端发送标准的 json 对象，后端通过 jackson 自动将其反序列化为 map。如果希望支持 url 查询参数形式的键值对，可以使用 @requestparam map，但需注意它仅适用于简单字符串类型的映射。
使用 @RequestBody 接收复杂 JSON 结构
当需要接收包含嵌套对象、数组或混合类型的复杂数据时，必须使用 @RequestBody。此时前端需设置请求头为 application/json，并将数据序列化为 JSON 字符串。Spring MVC 的 HttpMessageConverter 会自动将 JSON 解析为 Java 对象。对于 Map 而言，JSON 的 Key 对应 Map 的 Key，Value 则根据内容被转换为对应的 Java 类型（如 String、Integer、List 等）。若 Value 类型不确定，建议使用 Object 作为泛型参数，并在业务层进行类型检查。
{
"@RestController",
"public class DataController {\n @PostMapping(\"/api/data\")\n public ResponseEntity<map object>> handleData(@RequestBody Map<string object> payload) {\n // 处理逻辑\n return ResponseEntity.ok(payload);\n }\n}</string></map>
上述代码定义了一个 POST 接口，接收任意 JSON 对象并原样返回。测试时可使用 curl 命令：curl -X POST http://localhost:8080/api/data -H "Content-Type: application/json" -d '{"key1":"value1", "key2":123}'。返回结果将保持原始 JSON 结构，便于后续处理。
使用 @RequestParam 接收简单键值对
对于简单的键值对数据，尤其是来自表单或 URL 查询参数的场景，可以使用 @RequestParam Map。这种方式不需要设置 Content-Type 为 JSON，而是通过 URL 编码或表单提交。每个参数名作为 Map 的 Key，参数值作为 Value。需要注意的是，所有值都会被强制转换为 String 类型，无法直接接收数字或布尔值。此外，如果存在同名参数，Map 中只会保留最后一个值，除非使用 MultiValueMap。
{
"@RestController",
"public class QueryController {\n @GetMapping(\"/api/query\")\n public ResponseEntity<map string>> handleQuery(@RequestParam Map<string string> params) {\n return ResponseEntity.ok(params);\n }\n}</string></map>
该 GET 接口可接收类似 /api/query?name=John&age=30 的请求。返回的 Map 中，name 和 age 均为 String 类型，即使传入的是数字也会转为字符串。这种方式适合轻量级数据交换，但不适合结构化数据。
Map 中嵌套对象时的类型转换问题
在使用 @RequestBody 接收 Map 时，若 JSON 中包含嵌套对象，Jackson 会将其转换为 LinkedHashMap 实例。例如，输入 {"user":{"name":"Alice"}}，Map 中的 user 键对应的值是一个 Map 对象，而非自定义 POJO。开发者需在业务代码中手动进行类型转换，或使用 TypeReference 指定具体类型。若未正确处理，可能导致 ClassCastException。建议在使用前通过 instanceof 检查类型，或结合 DTO 类进行强类型约束。
