Spring Boot如何实现类似C# WebAPI的RoutePrefix控制器路由前缀？

当然可行，Spring Boot提供了多种方式实现类似C# WebAPI中[RoutePrefix]的效果，以下是几种常用方案：

1. 控制器类上直接使用@RequestMapping注解 #

这是最直接的方式，在控制器类上添加@RequestMapping指定统一前缀，类内所有端点的路由都会自动拼接该前缀：

@RequestMapping("/MyController")
@RestController
public class MyController {
    // 实际路由为 /MyController/endpoint1
    @GetMapping("/endpoint1")
    public String getEndpoint1() {
        return "Response from endpoint1";
    }

    // 实际路由为 /MyController/endpoint2
    @PostMapping("/endpoint2")
    public String postEndpoint2() {
        return "Response from endpoint2";
    }
}

如果需要更精确的请求方法限制，也可以用@GetMapping/@PostMapping等注解直接标注在类上，比如@GetMapping("/MyController")，类内方法的路由会基于该前缀继续拼接。

2. 批量给多个控制器添加统一前缀（Spring Boot 2.6+） #

如果需要给某个包下的所有控制器统一添加前缀，无需逐个修改控制器类，可以通过@ControllerAdvice结合RequestMappingHandlerMapping实现：

@ControllerAdvice(basePackages = "com.yourpackage.controller")
public class GlobalControllerPrefixConfig implements InitializingBean {
    private final RequestMappingHandlerMapping requestMappingHandlerMapping;

    // 构造注入RequestMappingHandlerMapping
    public GlobalControllerPrefixConfig(RequestMappingHandlerMapping requestMappingHandlerMapping) {
        this.requestMappingHandlerMapping = requestMappingHandlerMapping;
    }

    @Override
    public void afterPropertiesSet() throws Exception {
        requestMappingHandlerMapping.getHandlerMethods().forEach((requestMappingInfo, handlerMethod) -> {
            Class<?> controllerClass = handlerMethod.getBeanType();
            // 仅处理指定包下的控制器
            if (controllerClass.getPackageName().startsWith("com.yourpackage.controller")) {
                PatternsRequestCondition originalPatterns = requestMappingInfo.getPatternsCondition();
                List<String> newPatterns = new ArrayList<>();
                // 给每个原有路由前缀添加统一前缀
                for (String pattern : originalPatterns.getPatterns()) {
                    newPatterns.add("/MyController" + pattern);
                }
                // 构造新的路由条件并重新注册
                PatternsRequestCondition updatedPatterns = new PatternsRequestCondition(
                        newPatterns.toArray(new String[0]),
                        requestMappingHandlerMapping.getUrlPathHelper(),
                        requestMappingHandlerMapping.getPathMatcher(),
                        true,
                        null,
                        null,
                        "/"
                );
                RequestMappingInfo updatedRequestMappingInfo = RequestMappingInfo.paths(updatedPatterns.getPatternsArray())
                        .methods(requestMappingInfo.getMethodsCondition().getMethods().toArray(RequestMethod[]::new))
                        .params(requestMappingInfo.getParamsCondition().getExpressions().toArray(RequestParam[]::new))
                        .headers(requestMappingInfo.getHeadersCondition().getExpressions().toArray(RequestHeader[]::new))
                        .consumes(requestMappingInfo.getConsumesCondition().getConsumableMediaTypes().toArray(MediaType[]::new))
                        .produces(requestMappingInfo.getProducesCondition().getProducibleMediaTypes().toArray(MediaType[]::new))
                        .build();
                requestMappingHandlerMapping.registerMapping(updatedRequestMappingInfo, handlerMethod.getBean(), handlerMethod.getMethod());
            }
        });
    }
}

这种方式适合大规模统一修改路由前缀的场景，无需改动原有控制器代码。

3. 全局路由前缀配置（针对所有控制器） #

如果需要给所有控制器添加统一前缀，还可以通过配置文件实现：
在application.properties中添加：

spring.mvc.servlet.path=/MyController

或者application.yml：

spring:
  mvc:
    servlet:
      path: /MyController

这种方式会让整个应用的所有请求都带上/MyController前缀，包括静态资源等，使用时需注意是否符合业务需求。

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