You need to enable JavaScript to run this app. Java/Spring如何不将@GetMapping改为@PostMapping向控制器传递UUID列表
优惠活动
大模型
产品
解决方案
定价
更多

Java/Spring如何不将@GetMapping改为@PostMapping向控制器传递UUID列表

GET请求传递UUID数组参数解决方案

报错原因

@RequestParam注解只会从URL的查询参数(Query Parameter)中提取值,你将JSON结构放在请求体中提交,一方面@RequestParam不会主动扫描请求体内容,另一方面HTTP协议中GET请求默认不承载请求体,部分Spring MVC配置也会直接忽略GET请求的请求体,因此会抛出参数缺失的报错。

另外你当前代码中@GetMapping("/product/{productUuidList}")定义的路径占位符{productUuidList}没有被使用,属于冗余配置,可以直接删除。

可行解决方案

方案一:无需修改后端代码(推荐,符合HTTP规范)

@RequestParam原生支持同key多值的参数自动封装为列表,你只需要按照如下格式构造请求URL即可:

https://你的服务地址/product?productUuidList=c849bcbb-c26c-4299-9ca4-dcde56830f5f&productUuidList=398ec0f8-86c8-400a-93cb-caf47c1ac92d

Postman操作方式:切换到Params标签页,添加两行键为productUuidList的记录,分别填入两个UUID的值即可,Spring会自动将多个同键参数组装为List<UUID>对象。

方案二:微调后端代码,支持JSON格式传参

如果必须使用JSON格式传递数组,可以选择以下两种实现:

方式1:JSON串作为查询参数传递

修改后端接口逻辑,先接收字符串格式的参数,再手动反序列化为UUID列表:

@GetMapping("/product")
public ResponseEntity<ApiResponse<List<ProductDTO>>> getProductList(
        @RequestParam String productUuidList) throws JsonProcessingException {
    ObjectMapper objectMapper = new ObjectMapper();
    List<UUID> uuidList = objectMapper.readValue(productUuidList, new TypeReference<List<UUID>>() {});
    // 原有业务逻辑
}

Postman传参格式:将JSON数组作为productUuidList的参数值传递即可,Postman会自动对JSON特殊字符做URL编码:

?productUuidList=["c849bcbb-c26c-4299-9ca4-dcde56830f5f","398ec0f8-86c8-400a-93cb-caf47c1ac92d"]

方式2:GET请求携带请求体(不推荐)

如果一定要把JSON放在请求体中传递,首先需要调整Web容器配置允许GET请求携带请求体,然后修改接口参数注解为@RequestBody:

@GetMapping("/product")
public ResponseEntity<ApiResponse<List<ProductDTO>>> getProductList(
        @RequestBody Map<String, List<UUID>> params) {
    List<UUID> productUuidList = params.get("productUuidList");
    // 原有业务逻辑
}

注意:该方式不符合HTTP语义规范,部分网关、代理服务器会直接丢弃GET请求的请求体,可能导致跨环境调用失败。

内容的提问来源于stack exchange,提问作者Jack

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 07:39:02