Java/Spring如何不将@GetMapping改为@PostMapping向控制器传递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

