Spring Boot如何仅在单个Controller中忽略server.contextPath属性？

当然有办法！下面给你几个实用的方案，根据你的Spring版本和需求选择即可：

方案1：双斜杠绝对路径映射（最简单） #

直接在Controller的请求映射上用双斜杠开头，Spring会自动跳过全局配置的server.contextPath，直接映射到Servlet容器的根路径：

@RestController
public class RootController {
    // 该方法将处理 http://localhost:8888/ 的请求
    @GetMapping("//")
    public String handleRootRequest() {
        return "Successfully handled root path without context!";
    }
}

这个方式在Spring Boot 1.x和2.x版本中都能生效，不需要额外配置，非常省心。

方案2：自定义RequestMappingHandlerMapping（更灵活） #

如果需要多个Controller都不受contextPath影响，或者想做更精细的路径控制，可以自定义RequestMappingHandlerMapping来修改路径匹配逻辑：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Value("${server.contextPath:/}")
    private String globalContextPath;

    @Bean
    public RequestMappingHandlerMapping rootRequestMappingHandlerMapping() {
        RequestMappingHandlerMapping handlerMapping = new RequestMappingHandlerMapping();
        // 给这个handlerMapping设置空前缀，让它的映射不受全局contextPath约束
        handlerMapping.setPrefix("");
        handlerMapping.setUseSuffixPatternMatch(false);
        // 指定哪些包下的Controller使用这个规则
        handlerMapping.setBasePackages("com.yourproject.rootcontrollers");
        return handlerMapping;
    }
}

把需要忽略contextPath的Controller放到指定包下，它们的请求映射就会直接基于容器根路径生效。

方案3：用ServletRegistrationBean注册独立逻辑（特殊场景适用） #

如果你的根路径处理逻辑比较简单独立，也可以直接把它包装成Servlet，绕过Spring MVC的上下文路径规则：

@Configuration
public class RootServletConfig {
    @Bean
    public ServletRegistrationBean<HttpServlet> rootServlet() {
        HttpServlet rootServlet = new HttpServlet() {
            @Override
            protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
                resp.getWriter().write("Handled root path via direct servlet registration!");
            }
        };
        // 直接注册到容器根路径
        return new ServletRegistrationBean<>(rootServlet, "/");
    }
}

这个方式完全脱离Spring MVC的映射体系，适合只需要简单响应根路径请求的场景。

小提醒 #

如果你使用的是Spring Boot 2.x及以上版本，原来的server.contextPath配置已经被替换为server.servlet.context-path，记得同步调整配置文件哦~

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