JDK17下通过反射修改@RequestMapping注解值无效问题

你通过BeanPostProcessor修改@RequestMapping注解属性的方式无效，核心原因有两点：

1. Spring MVC在容器初始化早期就完成了@RequestMapping注解的解析和请求映射注册，后续修改注解属性不会触发映射信息的重新注册；
2. JDK 17对反射访问动态代理类的memberValues字段有更严格的权限限制，这种hack式的修改本身就不稳定且不被Spring官方推荐。

正确方案：扩展RequestMappingHandlerMapping #

Spring MVC的请求映射由RequestMappingHandlerMapping负责解析与注册，我们可以通过自定义它的子类，在映射解析阶段动态修改请求路径，这是官方认可的合法方式。

步骤1：定义自定义前缀注解（按需） #

如果需要为每个控制器指定不同的前缀，先定义一个标记注解：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface ControllerPrefix {
    String value(); // 存储控制器专属前缀
}

步骤2：自定义RequestMappingHandlerMapping子类 #

重写getMappingForMethod方法，在解析控制器方法的映射信息时动态调整路径：

public class CustomRequestMappingHandlerMapping extends RequestMappingHandlerMapping {

    @Override
    protected RequestMappingInfo getMappingForMethod(Method method, Class<?> handlerType) {
        RequestMappingInfo originalMapping = super.getMappingForMethod(method, handlerType);
        if (originalMapping == null) {
            return null;
        }

        // 读取控制器类上的自定义前缀注解
        ControllerPrefix prefixAnnotation = handlerType.getAnnotation(ControllerPrefix.class);
        if (prefixAnnotation != null) {
            String prefix = prefixAnnotation.value();
            // 拼接新的请求路径
            PatternsRequestCondition updatedPatterns = new PatternsRequestCondition(
                    originalMapping.getPatternsCondition().getPatterns().stream()
                            .map(path -> prefix + path)
                            .toArray(String[]::new)
            );
            // 构建新的RequestMappingInfo替换原映射
            return new RequestMappingInfo(
                    originalMapping.getName(),
                    updatedPatterns,
                    originalMapping.getMethodsCondition(),
                    originalMapping.getParamsCondition(),
                    originalMapping.getHeadersCondition(),
                    originalMapping.getConsumesCondition(),
                    originalMapping.getProducesCondition(),
                    originalMapping.getCustomCondition()
            );
        }

        return originalMapping;
    }
}

步骤3：注册自定义HandlerMapping #

通过配置类替换默认的RequestMappingHandlerMapping实现：

@Configuration
public class WebMvcConfig implements WebMvcRegistrations {

    @Override
    public RequestMappingHandlerMapping getRequestMappingHandlerMapping() {
        return new CustomRequestMappingHandlerMapping();
    }
}

步骤4：在控制器上使用注解 #

@RestController
@ControllerPrefix("/admin")
@RequestMapping("/user")
public class AdminUserController {

    @GetMapping("/detail")
    public String getUserDetail() {
        return "admin user detail";
    }
}

原本的/user/detail会被动态映射为/admin/user/detail，直接通过Postman访问新路径即可生效。

简化方案（Spring Boot 2.6+） #

如果只需要基于特定规则统一添加前缀（比如给所有带特定注解的控制器加同一个前缀），可以直接用WebMvcConfigurer的addPathPrefix方法：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addPathPrefix(String prefix, HandlerTypePredicate predicate) {
        // 给所有带有@AdminController注解的控制器添加/admin前缀
        WebMvcConfigurer.super.addPathPrefix("/admin", predicate.forAnnotation(AdminController.class));
    }
}

这种方式代码更简洁，但灵活性不如自定义HandlerMapping，适合规则统一的场景。

内容的提问来源于stack exchange，提问作者Manni