Spring MVC 自定义 HandlerMethodArgumentResolver 需实现接口、精准匹配 supportsParameter（按类型/注解/组合判断）、在 resolveArgument 中安全提取参数、通过 WebMvcConfigurer 的 addArgumentResolvers 注册，且 Controller 签名须与匹配规则一致。
Spring MVC 中配置自定义 HandlerMethodArgumentResolver 的核心在于：实现接口、明确支持条件、完成参数提取与封装，并正确注册到 MVC 解析链中。它不是“加个注解就生效”，而是需要你控制“什么参数该由谁来解析”以及“怎么从请求里取值”。整个过程不依赖 AOP 或拦截器，轻量且侵入性低。
明确 supportsParameter 的判断逻辑
这个方法决定你的解析器是否参与当前参数的处理。关键不是“所有参数都试试”，而是精准匹配：
- 按参数类型判断：比如只处理
@CurrUser CurrUserVo或UserLoginInfo类型的入参 - 按注解判断：配合自定义注解（如
@CurrentUser、@RequestHeaderParam），检查parameter.getParameterAnnotation(YourAnnotation.class)是否存在 - 组合判断：既要求类型是
OrderQuery，又要求有@Validated注解，避免误触发 - 注意顺序：多个解析器共存时，Spring 按注册顺序逐个调用
supportsParameter，第一个返回true的才会执行resolveArgument
在 resolveArgument 中安全提取并构造对象
一旦进入此方法，说明已通过前置判断。这里要专注“从请求中读什么、怎么转、怎么校验”：
- 从
NativeWebRequest获取原始请求信息：可调用webRequest.getParameter("xxx")、webRequest.getHeader("Authorization")、webRequest.getNativeRequest(HttpServletRequest.class) - 避免空指针：对
getParameter返回值做非空校验；数字类字段用NumberUtils.toInt()替代Integer.parseInt() - 支持嵌套结构：若需解析 JSON 字符串为对象，可用
ObjectMapper.readValue(webRequest.getParameter("json"), TargetClass.class) - 统一异常处理：解析失败时抛出
IllegalArgumentException或自定义业务异常，Spring 会交由全局异常处理器捕获
通过 WebMvcConfigurer 正确注册解析器
注册位置决定了它能否被 Spring MVC 调用。必须在 WebMvcConfigurer 的 addArgumentResolvers 方法中添加：
立即学习“Java免费学习笔记（深入）”；
- 不要用
@Bean直接注入，Spring 不识别这种形式的 resolver - 推荐在配置类中实现
WebMvcConfigurer接口，并重写addArgumentResolvers - 若需插入到内置解析器之前（例如覆盖默认行为），用
resolvers.add(0, yourResolver)；常规场景直接resolvers.add(yourResolver)即可 - Spring Boot 2.6+ 默认禁用部分旧解析器，确保你的 resolver 不依赖已移除的内部类（如
ServletModelAttributeMethodProcessor的变体）
Controller 层使用方式要匹配设计意图
解析器生效的前提是 Controller 方法签名与 supportsParameter 的约定一致：
- 如果解析器只支持带
@MyParam注解的SearchCriteria，那方法就得写成public Result list(@MyParam SearchCriteria criteria) - 如果解析器按类型匹配（如所有
PageRequest），则直接写PageRequest page即可，无需注解 - 避免和内置解析器冲突：例如不要让自定义 resolver 去处理
@RequestBody参数，除非你明确替换了RequestResponseBodyMethodProcessor - 调试技巧：在
supportsParameter和resolveArgument中加日志，观察哪些请求进了哪个解析器
