Spring MVC中自定义参数解析器需实现HandlerMethodArgumentResolver接口，重写supportsParameter和resolveArgument方法，通过WebMvcConfigurer注册到解析链，并在控制器中用自定义注解直接注入参数。
在 Spring MVC 中，自定义参数解析器（HandlerMethodArgumentResolver）是为了让控制器方法能直接接收特定类型的参数，而无需每次手动从 HttpServletRequest 或 @RequestBody 解析。核心是实现接口、注册到容器，并确保它在参数解析链中生效。
实现 HandlerMethodArgumentResolver 接口
你需要创建一个类，实现 HandlerMethodArgumentResolver 接口，重写两个关键方法：
-
supportsParameter：判断当前解析器是否支持该控制器参数（根据参数类型、注解等条件返回
true） - resolveArgument：真正执行解析逻辑，从请求中提取数据并封装成目标对象返回
例如，定义一个注解 @CurrentUserId，用于自动注入当前登录用户 ID：
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface CurrentUserId {}
对应解析器：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public class CurrentUserIdArgumentResolver implements HandlerMethodArgumentResolver {
@Override
public boolean supportsParameter(MethodParameter parameter) {
return parameter.hasParameterAnnotation(CurrentUserId.class);
}
<pre class='brush:java;toolbar:false;'>@Override
public Object resolveArgument(MethodParameter parameter,
ModelAndViewContainer mavContainer,
NativeWebRequest webRequest,
WebDataBinderFactory binderFactory) throws Exception {
// 假设用户 ID 存在请求头 X-User-ID 中
String userIdStr = webRequest.getHeader("X-User-ID");
if (userIdStr == null || userIdStr.trim().isEmpty()) {
throw new IllegalArgumentException("Missing X-User-ID header");
}
return Long.parseLong(userIdStr); // 返回 long 类型，匹配控制器参数类型
}}
注册自定义解析器
Spring Boot 2.0+ 推荐通过配置类方式注册，确保它被加入到 Spring MVC 的参数解析器链中：
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
// 添加到最前面，优先匹配（可选）
resolvers.add(0, new CurrentUserIdArgumentResolver());
}
}
注意：
- 不要使用 @Bean 直接声明解析器（除非配合 WebMvcConfigurationSupport 并重写 addArgumentResolvers），否则可能被默认配置覆盖。
- 如果已有其他自定义解析器，注意顺序——Spring 按列表顺序遍历，第一个返回 true 的 resolver 才会执行 resolveArgument。
在 Controller 中使用
定义好后，控制器方法即可直接使用：
@GetMapping("/profile")
public ResponseEntity<?> getProfile(@CurrentUserId Long userId) {
// userId 已自动注入，无需手动获取
return ResponseEntity.ok(userService.findById(userId));
}
只要请求携带 X-User-ID: 123，该参数就会被自动解析为 long 类型的 userId。
常见注意事项
- 参数类型必须与
resolveArgument返回值严格匹配（如返回Long，控制器参数就得是Long或long） - 如果解析失败（如格式错误、缺失必要信息），应在
resolveArgument中抛出明确异常（如IllegalArgumentException），Spring 会转为400 Bad Request - 若需访问 session、cookie 或请求体内容，可通过
NativeWebRequest获取HttpServletRequest或HttpServletResponse - 不建议在解析器中做耗时操作（如远程调用），会影响请求处理性能
