运行时注册Spring @RestController端点无法访问的解决方案

问题根因 #

直接通过((GenericApplicationContext) applicationContext).registerBeanDefinition(name, beanDefinition)方式注册@RestController类型Bean时，Spring MVC负责请求路由的核心组件RequestMappingHandlerMapping已经在应用启动阶段完成初始化，默认仅扫描启动阶段已存在的控制器Bean，不会自动感知运行时新增的控制器，因此对应接口不会被加入路由表，最终导致无法访问。

可行实现方案 #

• 方案1：注册Bean后主动触发映射扫描（最通用，兼容原生Spring、Spring Boot全版本）
  完成Bean注册后，直接从容器中获取RequestMappingHandlerMapping实例，调用其公开的方法检测新注册控制器的接口映射即可，示例代码：

  // 原有Bean注册逻辑
  GenericApplicationContext context = (GenericApplicationContext) applicationContext;
  context.registerBeanDefinition(controllerName, beanDefinition);
  
  // 新增：主动注册请求映射
  RequestMappingHandlerMapping handlerMapping = context.getBean(RequestMappingHandlerMapping.class);
  Object controllerInstance = context.getBean(controllerName);
  // 扫描该控制器下所有带@RequestMapping注解的方法，自动注册路由
  handlerMapping.detectHandlerMethods(controllerInstance);
  

  该方法会自动识别类上、方法上的@RequestMapping及衍生注解（@GetMapping/@PostMapping等），自动拼接类级路径前缀，和静态声明的控制器行为完全一致。

• 方案2：直接动态注册路由映射（适合不需要IOC管理控制器实例的场景）
  如果不需要将控制器纳入Spring Bean生命周期管理，可以跳过Bean注册流程，直接在运行时构建请求映射信息注册到RequestMappingHandlerMapping中：

  RequestMappingHandlerMapping handlerMapping = applicationContext.getBean(RequestMappingHandlerMapping.class);
  // 构建路由规则：GET请求 /dynamic/hello
  RequestMappingInfo mappingInfo = RequestMappingInfo
          .paths("/dynamic/hello")
          .methods(RequestMethod.GET)
          .produces(MediaType.APPLICATION_JSON_VALUE)
          .build();
  // 绑定路由对应的处理方法：传入控制器实例、具体处理的Method对象
  Object controller = new YourDynamicController();
  Method handleMethod = controller.getClass().getMethod("hello");
  handlerMapping.registerMapping(mappingInfo, controller, handleMethod);
  

• 方案3：在容器刷新前注册Bean定义（无额外侵入，和静态控制器表现完全一致）
  如果动态注册逻辑的执行时机可以提前到Spring容器刷新之前，可通过实现BeanDefinitionRegistryPostProcessor扩展点，在postProcessBeanDefinitionRegistry方法中完成@RestController的BeanDefinition注册，这部分Bean会被RequestMappingHandlerMapping在启动阶段自动扫描到，不需要额外手动触发映射注册。

注意事项 #

• 动态注册的接口如果被Spring Security、自定义拦截器、过滤器拦截，会返回401、403或其他拦截错误，注意提前配置对应路径的放行规则，不要误判为路由注册失败。
• 重复注册同一路由会抛出异常，注册前可先通过RequestMappingHandlerMapping#getHandlerMethods方法校验路径是否已存在。
• 如果项目中存在多个RequestMappingHandlerMapping实例（比如部分版本Spring MVC默认注册和Spring Data REST等扩展组件带来的额外实例），需要对所有实例执行映射注册操作，避免路由匹配失败。

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