HandlerMethodArgumentResolver 是 Spring MVC 中用于自定义控制器参数解析的核心扩展点，支持通过注解（如 @CurrentUser）或类型匹配自动注入对象，需实现 supportsParameter 和 resolveArgument 方法并在 WebMvcConfigurer 中注册。
在 Spring MVC 中，HandlerMethodArgumentResolver 是处理控制器方法参数的核心扩展点。通过自定义它，你可以让 REST 接口直接接收自定义对象、从特定位置（如 Header、Cookie、JWT 载荷）提取并组装参数，而无需在每个 @RequestMapping 方法里手动解析。
理解 HandlerMethodArgumentResolver 的作用时机
它在 Spring MVC 的请求处理链中，位于 HandlerAdapter 内部，在调用 Controller 方法前被触发。Spring 会遍历所有注册的 resolver，对方法中每个参数尝试匹配——只要某个 resolver 的 supportsParameter 返回 true，就由它的 resolveArgument 方法提供实际值。
实现一个自定义参数解析器（以解析 JWT 用户信息为例）
假设你希望在接口中直接声明 @CurrentUser User user，自动从 Authorization Header 解析 JWT 并加载用户实体：
- 定义一个注解标记目标参数：
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface CurrentUser {} - 实现
HandlerMethodArgumentResolver：
public class CurrentUserArgumentResolver implements HandlerMethodArgumentResolver {
@Override
public boolean supportsParameter(MethodParameter parameter) {
return parameter.hasParameterAnnotation(CurrentUser.class)
&& User.class.isAssignableFrom(parameter.getParameterType());
}
@Override
public Object resolveArgument(MethodParameter parameter,
ModelAndViewContainer mavContainer,
NativeWebRequest webRequest,
WebDataBinderFactory binderFactory) throws Exception {
String token = webRequest.getHeader("Authorization");
if (token != null && token.startsWith("Bearer ")) {
String jwt = token.substring(7);
return jwtUserService.loadUserFromJwt(jwt); // 自定义服务
}
return null; // 或抛异常，如未认证
}
}
注册自定义解析器
Spring Boot 2.0+ 推荐在配置类中重写 addArgumentResolvers：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- @Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
resolvers.add(new CurrentUserArgumentResolver());
}
} - 注意：自定义 resolver 默认插入到内置 resolver 列表末尾；如需更高优先级（例如覆盖默认的
@RequestParam行为），可使用resolvers.add(0, ...)插入开头。
配合 @ModelAttribute 实现更通用的参数绑定
如果想支持非注解驱动的自动绑定（比如所有 UserContext 类型参数都走同一逻辑），可在 supportsParameter 中判断参数类型而非注解，并确保该类型不被其他 resolver（如 ModelAttributeMethodProcessor）提前拦截。此时建议将 resolver 注册在靠前位置，并在 resolveArgument 中主动构造对象，避免与默认模型绑定逻辑冲突。
这种方式让接口更简洁、逻辑更内聚，也便于统一做权限校验、审计日志等横切操作。关键在于精准控制 supportsParameter 的匹配条件，并确保 resolveArgument 返回值类型与方法参数一致。
