spring boot 全局异常处理捕获视图查询异常的核心做法是注册一个实现 handlerexceptionresolver 接口的 bean,并在其中拦截 org.springframework.web.servlet.pagenotfound 或 nohandlerfoundexception。当 spring mvc 找不到匹配的请求映射时,会抛出这些异常,通过自定义解析器可以统一返回 json 响应或重定向到错误页面,从而避免默认的 404 白页。

如何配置全局异常处理器以捕获 404 异常
要捕获视图查询异常(通常指 404 Not Found),需要确保 throw-exception-if-no-handler-found 属性设置为 true,并禁用默认的资源解析器。这样当请求无法匹配任何 Controller 方法时,Spring 会抛出 NoHandlerFoundException,而不是直接返回 404 状态码。接着,创建一个类实现 HandlerExceptionResolver,重写 resolveException 方法,在该方法中判断异常类型是否为 NoHandlerFoundException,如果是,则构建一个统一的错误响应对象并返回。

import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.NoHandlerFoundException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.HashMap;
import java.util.Map;
@Component
public class GlobalExceptionHandler implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
if (ex instanceof NoHandlerFoundException) {
response.setStatus(404);
response.setContentType("application/json;charset=UTF-8");
try {
Map<string object> result = new HashMap();
result.put("status", 404);
result.put("message", "Resource not found: " + request.getRequestURI());
response.getWriter().write(new com.fasterxml.jackson.databind.ObjectMapper().writeValueAsString(result));
} catch (Exception e) {
e.printStackTrace();
}
return new ModelAndView();
}
return null;
}
}</string>
上述代码定义了一个名为 GlobalExceptionHandler 的组件,它实现了 HandlerExceptionResolver 接口。在 resolveException 方法中,首先检查异常是否为 NoHandlerFoundException。如果是,则将 HTTP 响应状态码设置为 404,并设置内容类型为 JSON。然后,使用 Jackson 的 ObjectMapper 将包含状态码和消息的 Map 转换为 JSON 字符串写入响应体。最后返回空的 ModelAndView 以阻止后续处理。如果异常不是 NoHandlerFoundException,则返回 null,让其他解析器继续处理。
如何处理其他类型的运行时异常
除了 404 异常,全局异常处理器还可以捕获其他常见的运行时异常,如 RuntimeException 或自定义的业务异常。通过在同一个 resolveException 方法中添加更多的条件判断,可以针对不同异常类型返回不同的错误信息。例如,对于 RuntimeException,可以记录日志并返回通用的内部服务器错误响应。这样可以确保所有未处理的异常都能被优雅地捕获,并提供一致的错误反馈给用户。

import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.NoHandlerFoundException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.HashMap;
import java.util.Map;
@Component
public class GlobalExceptionHandler implements HandlerExceptionResolver {
@Override
public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
if (ex instanceof NoHandlerFoundException) {
response.setStatus(404);
response.setContentType("application/json;charset=UTF-8");
try {
Map<string object> result = new HashMap();
result.put("status", 404);
result.put("message", "Resource not found: " + request.getRequestURI());
response.getWriter().write(new com.fasterxml.jackson.databind.ObjectMapper().writeValueAsString(result));
} catch (Exception e) {
e.printStackTrace();
}
return new ModelAndView();
} else if (ex instanceof RuntimeException) {
response.setStatus(500);
response.setContentType("application/json;charset=UTF-8");
try {
Map<string object> result = new HashMap();
result.put("status", 500);
result.put("message", "Internal server error");
response.getWriter().write(new com.fasterxml.jackson.databind.ObjectMapper().writeValueAsString(result));
} catch (Exception e) {
e.printStackTrace();
}
return new ModelAndView();
}
return null;
}
}</string></string>
扩展后的 GlobalExceptionHandler 增加了对 RuntimeException 的处理。当捕获到 RuntimeException 时,将 HTTP 响应状态码设置为 500,并返回包含通用错误信息的 JSON 响应。这种处理方式确保了无论是资源未找到还是内部服务器错误,用户都能收到明确的错误提示。同时,由于所有异常处理逻辑都集中在一个类中,便于维护和扩展。
基于 NoHandlerFoundException 的具体问题:如何获取请求 URI
在处理 NoHandlerFoundException 时,经常需要获取导致异常的请求 URI 以便在错误消息中展示。可以通过 HttpServletRequest 对象的 getRequestURI() 方法获取请求的 URI。这个 URI 包含了请求的路径部分,不包括查询参数。如果需要完整的 URL,可以使用 getRequestURL() 方法。在实际应用中,可以根据需求选择合适的方法来获取请求信息,以便提供更详细的错误反馈。











