如何让@RequestParam接收json对象内部参数

### @RequestParam 异常处理及常见原因分析 @RequestParam 是 Spring MVC 提供的一个注解，用于绑定 HTTP 请求中的参数到控制器方法的形参上。当使用该注解时，可能会遇到一些常见的异常情况，比如缺少必需参数、数据类型不匹配等。 #### 常见异常及其原因 1. **MissingServletRequestParameterException** 当请求中未提供带有 `@RequestParam` 注解的必填参数（即 required 属性设置为 true 或默认值），Spring 将抛出此异常[^1]。例如，在以下代码片段中，如果请求中没有传递 `tradeTime` 参数，则会触发 MissingServletRequestParameterException： ```java public void test(@RequestParam(value = "tradeTime") String tradeTime) throws InternalApiException {} ``` 2. **TypeMismatchException** 如果请求参数存在但其值无法转换为目标类型的格式，将会引发 TypeMismatchException。这通常发生在尝试将字符串形式的数据强制转换成其他复杂类型失败的情况下[^2]。例如，假设期望的是整数型 ID 而实际接收到的是字母串，则会发生此类错误。 3. **HttpMessageNotReadableException** 这种异常较少由单独的 @RequestParam 导致，更多时候与 JSON 序列化/反序列化有关。但如果配置不当或者消息体不符合预期结构也可能间接引起这个问题。 #### 自定义全局异常处理器实现方式 为了更好地管理这些潜在问题并返回统一友好的提示给前端开发者们了解具体哪里出了差错而不是仅仅看到一堆堆栈信息，可以通过创建一个专门用来解决各种业务逻辑之外的技术层面故障点——也就是所谓的“通用异常拦截器”。 下面展示如何通过继承 HandlerInterceptorAdapter 类来完成这一目标；不过更推荐的方式是像这样直接编写一个新的 Java Bean 并让它去实现 org.springframework.web.servlet.HandlerExceptionResolver 接口从而获得更大的灵活性以及可扩展空间: ```java @Component public class CustomExceptionResolver implements HandlerExceptionResolver { private static final Logger logger = LoggerFactory.getLogger(CustomExceptionResolver.class); @Override public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { // 记录日志 logger.error("Request URL : {}, Exception : {}", request.getRequestURL(), ex); ResponseResult result; if (ex instanceof MissingServletRequestParameterException){ result = new ResponseResult(HttpStatus.BAD_REQUEST.value(), HttpStatus.BAD_REQUEST.getReasonPhrase(),"缺失必要参数"); }else if(ex instanceof TypeMismatchException ){ result=new ResponseResult(HttpStatus.INTERNAL_SERVER_ERROR.value(), HttpStatus.INTERNAL_SERVER_ERROR.getReasonPhrase(),"类型转换错误"); } else{ result= new ResponseResult(HttpStatus.INTERNAL_SERVER_ERROR.value(), HttpStatus.INTERNAL_SERVER_ERROR.getReasonPhrase(),"服务器内部错误"); } try { ObjectMapper objectMapper = new ObjectMapper(); response.setContentType(MediaType.APPLICATION_JSON_VALUE); response.setStatus(result.getCode()); response.getWriter().write(objectMapper.writeValueAsString(result)); } catch (IOException e) { logger.error(e.getMessage(),e); } return null; } } ``` 上述代码展示了如何针对不同种类的运行期意外状况作出相应的反应措施，并且把最终的结果封装进 Json 格式的实体对象里再反馈回去客户端那边以便于他们能够清晰明了地知道发生了什么问题[^3]。 关于为何有时候即使设置了全局异常捕捉机制仍然会有部分特定状态码得不到妥善处置的现象，请参照官方文档深入探讨底层运作原理找出确切答案[^4]。

### Spring MVC 注解功能与使用方法 #### @RequestMapping 功能与使用方法 @RequestMapping 是用于处理HTTP请求和响应的核心注解之一。此注解可以应用于类级别或方法级别，用来定义控制器中的具体请求映射关系[^1]。 对于具体的URL路径匹配，可以通过`value`属性指定。例如： ```java @RequestMapping("/welcome") public String welcome() { return "Welcome Page"; } ``` 当需要限定特定的HTTP请求方式时，则可利用`method`属性来设置支持的方法类型，如GET、POST等: ```java @RequestMapping(value = "/login", method = RequestMethod.POST) public String login() { return "Login Result"; } ``` #### @RequestParam 功能与使用方法 @RequestParam 主要作用是从查询字符串中获取参数值并将其绑定到处理器方法形参上。如果前端发送的是 key-value 形式的 URL 参数，那么就可以采用这种方式接收数据[^4]。 示例代码如下所示： ```java @GetMapping("/test") public String test(@RequestParam("id") Integer id, Model model){ // 处理逻辑... } ``` 这里 `@RequestParam("id")` 表明会从请求链接里提取名为 'id' 的参数，并尝试转换成 Java 类型 Integer 后赋予变量 id。 #### @RequestBody 功能与使用方法 @RequestBody 则是用来读取 HTTP 请求体的内容，并自动解析为相应的对象实例。通常适用于 POST 或 PUT 方法提交 JSON/XML 数据的情况。 下面是一个简单的例子展示如何接受一个 User 对象作为入参： ```java @PostMapping("/saveUser") public ResponseEntity<String> saveUser(@RequestBody User user) { userService.save(user); return new ResponseEntity<>("success", HttpStatus.OK); } ``` 在这个场景下，客户端需按照预设的数据结构格式化输入流内容，以便服务器端能够顺利完成反序列化进程。 #### @PathVariable 功能与使用方法 @Pathvariable 专门针对 RESTful 风格 API 设计，在路由模式中含有动态部分的情况下非常有用。这些占位符可以直接对应于方法签名里的某个参数，从而简化了对 URL 中 ID 等标识信息的操作过程[^2]。 举个实际的例子来说： ```java @GetMapping("/users/{userId}") public ResponseEntity<User> getUserById(@PathVariable Long userId) { Optional<User> optionalUser = userRepository.findById(userId); return optionalUser.map(ResponseEntity::ok).orElseGet(() -> ResponseEntity.notFound().build()); } ``` 上述片段展示了怎样通过 `{userId}` 来捕获来自 URL 路径上的用户编号，并把它传递给内部业务函数进一步处理。