Spring Boot应用如何为特定接口设置上下文路径访问例外？

你已经通过server.servlet.context-path=/myapp设置了全局上下文路径，要让/exception路径绕过该上下文直接访问，有几种可行的实现方式：

方法一：注册独立Servlet（推荐） #

创建一个独立的Servlet处理/exception请求，该Servlet不受Spring Boot全局上下文路径的约束：

1. 编写自定义Servlet：

public class ExceptionServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 这里编写业务逻辑，如需返回Thymeleaf视图可手动转发
        req.getRequestDispatcher("/WEB-INF/templates/exception-page.html").forward(req, resp);
    }
}

2. 在配置类中注册该Servlet：

@Configuration
public class CustomServletConfig {
    @Bean
    public ServletRegistrationBean<ExceptionServlet> exceptionServletRegistration() {
        ServletRegistrationBean<ExceptionServlet> registrationBean = new ServletRegistrationBean<>(new ExceptionServlet());
        // 直接映射到根路径下的/exception
        registrationBean.addUrlMappings("/exception");
        // 设置启动优先级，确保该Servlet优先匹配请求
        registrationBean.setLoadOnStartup(1);
        return registrationBean;
    }
}

配置完成后，http://localhost:8080/exception会直接触发这个Servlet，无需带上/myapp前缀。

方法二：自定义Spring MVC HandlerMapping #

如果希望用Spring Controller处理该请求，可以通过自定义HandlerMapping绕过上下文路径：

1. 编写处理请求的Controller：

@Controller
public class ExceptionController {
    public String handleException(Model model) {
        // 业务逻辑处理，返回Thymeleaf视图名称
        model.addAttribute("message", "特殊异常页面");
        return "exception-page";
    }
}

2. 配置自定义HandlerMapping：

@Configuration
public class WebMvcCustomConfig implements WebMvcConfigurer {

    @Bean
    public SimpleUrlHandlerMapping exceptionUrlHandlerMapping() {
        SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping();
        // 设置最高优先级，确保该映射先被Spring MVC处理
        mapping.setOrder(Ordered.HIGHEST_PRECEDENCE);

        Map<String, Object> urlMap = new HashMap<>();
        // 直接映射根路径下的/exception到Controller方法
        urlMap.put("/exception", getExceptionHandlerMethod());

        mapping.setUrlMap(urlMap);
        return mapping;
    }

    private HandlerMethod getExceptionHandlerMethod() {
        try {
            return new HandlerMethod(new ExceptionController(), 
                ExceptionController.class.getMethod("handleException"));
        } catch (NoSuchMethodException e) {
            throw new RuntimeException("无法找到Controller方法", e);
        }
    }
}

此方法让Spring MVC直接匹配/exception路径，不受全局上下文路径影响。

注意事项 #

• 第一种方法更轻量，适合简单的独立请求；第二种方法适合需要整合Spring容器资源（如Service、视图解析器）的场景。
• 若使用Thymeleaf，确保视图路径配置正确，比如第一种方法中转发的路径要对应你的模板位置。

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