spring boot 全局异常处理捕获类型转换异常，核心是拦截 methodargumenttypemismatchexception。该异常在参数绑定阶段抛出，通过 @controlleradvice 配合 @exceptionhandler 注解即可统一处理。建议在配置类中注册 webmvcconfigurer 以自定义错误视图或消息格式，确保前端能接收到结构化的错误响应。
如何配置全局异常处理器并返回 JSON 响应
实现全局异常处理需要创建一个被 @RestControllerAdvice 或 @ControllerAdvice 标注的类。在该类中定义方法，并使用 @ExceptionHandler(MethodArgumentTypeMismatchException.class) 指定要捕获的异常类型。当请求参数无法转换为目标类型时，Spring MVC 会触发此异常，处理器将返回包含错误码和详细信息的 JSON 对象。这种方式避免了默认的 Whitelabel Error Page，提升了用户体验。
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentTypeMismatchException.class)
public ResponseEntity<String> handleTypeMismatch(MethodArgumentTypeMismatchException ex) {
String paramName = ex.getName();
String value = ex.getValue() != null ? ex.getValue().toString() : "";
return ResponseEntity.badRequest()
.body("Parameter '" + paramName + "' with value '" + value + "' is not of the correct type.");
}
}
如何处理路径变量中的类型转换失败
除了查询参数，路径变量（Path Variable）发生类型不匹配时同样会抛出 MethodArgumentTypeMismatchException。例如，URL 为 /api/users/abc 而控制器期望 Long id。上述全局处理器已覆盖此场景，无需额外配置。关键在于确保异常处理器能正确提取路径变量的名称和值，以便在前端展示具体的错误原因。若需更精细的控制，可结合 HandlerExceptionResolver 进行自定义逻辑。
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
@GetMapping("/users/{id}")
public String getUser(@PathVariable Long id) {
return "User ID: " + id;
}
}
类型转换异常发生时，实际获取到的参数值是什么
当类型转换失败时，MethodArgumentTypeMismatchException 对象的 getValue() 方法返回的是原始字符串形式的参数值，而非转换后的对象。例如，传入 ?age=twenty，getValue() 将返回字符串 "twenty"。开发者可利用此值构建友好的错误提示，告知用户输入的内容及预期类型。注意，若参数未提供，getValue() 可能返回 null，需做空值判断以避免空指针异常。
