Spring-MVC 中触发 404 错误的指南：实现方法和最佳实践

2024-03-11 23:23:52

在 Spring-MVC 控制器中触发 404 错误

在 Spring-MVC 中，你可能会遇到这样的场景：希望特定 URL 触发 404 错误，而不是由控制器处理。本文将深入探讨如何实现这一目标，包括代码示例和最佳实践。

问题：

假设有一个映射了所有 GET 请求的控制器，即 @RequestMapping(value = "/**", method = RequestMethod.GET)。然而，对于某些 URL，你希望容器直接返回 404 错误，绕过控制器处理。

解决方案：

步骤 1：添加一个不带请求映射的处理器方法

在你的控制器中，添加一个没有 @RequestMapping 注释的方法，如下所示：

@Controller
public class MyController {

    @RequestMapping(value = "/**", method = RequestMethod.GET)
    public String handleAllGetRequests() {
        // 处理所有 GET 请求的逻辑
    }

    public void handle404() {
        // 不处理任何请求的逻辑
    }
}

步骤 2：在 Spring 配置中注册 404 处理程序

在 Spring 配置文件中，注册一个 HandlerExceptionResolver bean，它将处理 404 错误并返回适当的响应。

XML 配置：

<bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
    <property name="defaultErrorView" value="error/404" />
</bean>

Java 配置：

@Configuration
public class WebMvcConfig {

    @Bean
    public SimpleMappingExceptionResolver exceptionResolver() {
        SimpleMappingExceptionResolver resolver = new SimpleMappingExceptionResolver();
        resolver.setDefaultErrorView("error/404");
        return resolver;
    }
}

步骤 3：创建 404 错误视图

创建一个名为 error/404 的视图，它将显示 404 错误消息。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<h1>404 Page Not Found</h1>

结果：

通过执行这些步骤，Spring-MVC 容器现在将直接返回 404 错误，而不调用控制器，对于某些预定义的 URL。

常见问题解答：

我可以使用 @ResponseStatus 注释吗？
是的，你可以使用 @ResponseStatus(HttpStatus.NOT_FOUND) 注释来直接触发 404 错误。然而，这将要求每个控制器方法都有单独的注释，而使用处理器方法更通用。
是否有其他方法来触发 404 错误？
你可以使用过滤器或拦截器在请求到达控制器之前处理错误。然而，这种方法通常不推荐，因为处理器方法更加直接和可配置。
如何处理 404 错误消息？
默认的 404 错误消息由容器生成。你可以通过在 error/404 视图中定制 HTML 来自定义消息。
为什么不使用 @ControllerAdvice？
@ControllerAdvice 主要用于处理异常。对于这种情况，处理器方法更合适，因为它专门用于触发 404 错误，而不是处理异常。
如何对不同的 URL 触发不同的 404 错误消息？
你可以在 SimpleMappingExceptionResolver 中使用 exceptionMappings 属性来指定特定异常类到错误视图的映射。这允许你为不同的 URL 提供自定义错误消息。