在Java开发中,处理HTTP请求时，404异常（Not Found）是一种常见的客户端错误，通常表示请求的资源不存在，正确捕获和处理404异常对于提升应用的健壮性和用户体验至关重要，本文将从基础概念、实现方式、最佳实践及注意事项四个方面，详细解析Java中如何有效捕获404异常。
404异常的常见场景
404异常通常出现在Web应用中,前端请求的API路径不存在、后端接口路径变更但未及时同步、资源文件（如图片、静态文件）路径错误等，在Spring Boot等框架中，未匹配到请求映射（@RequestMapping、@GetMapping等注解）的接口会自动抛出404异常，开发者需要明确异常来源，才能针对性地进行捕获和处理。
基于Servlet的404异常捕获
在传统Java Web应用（基于Servlet API）中，404异常的捕获主要通过web.xml配置或过滤器实现。
- 全局异常处理：在
web.xml中配置<error-page>标签，将404错误映射到特定的错误处理页面或Servlet：<error-page> <error-code>404</error-code> <location>/404</location> </error-page>然后在Servlet中处理该路径的请求,返回自定义错误信息或跳转页面。
- 过滤器拦截：通过过滤器（
Filter）拦截所有请求，检查请求路径是否有效，若无效则直接返回404响应。@WebFilter("/*") public class NotFoundFilter implements Filter { @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req = (HttpServletRequest) request; HttpServletResponse res = (HttpServletResponse) response; if (isInvalidPath(req.getRequestURI())) { res.sendError(HttpServletResponse.SC_NOT_FOUND, "Resource not found"); } else { chain.doFilter(request, response); } } }
Spring Boot中的404异常处理
Spring Boot提供了更灵活的异常处理机制，主要通过@ControllerAdvice和@ExceptionHandler注解实现全局异常捕获。
- 全局异常处理器：定义一个全局异常处理类，捕获
NoHandlerFoundException（Spring Boot未找到处理器时抛出的异常）：@ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(NoHandlerFoundException.class) public ResponseEntity<String> handleNotFound(NoHandlerFoundException ex) { return ResponseEntity.status(HttpStatus.NOT_FOUND) .body("Requested resource not found: " + ex.getRequestURL()); } }注意：需确保在
application.properties中开启spring.mvc.throw-exception-if-no-handler-found=true，否则404会被框架内部处理，不会抛出异常。 - 自定义错误响应：结合
@ResponseBody或返回自定义错误页面，实现更友好的用户提示。@ExceptionHandler(NoHandlerFoundException.class) public ResponseEntity<ErrorResponse> handleNotFound(NoHandlerFoundException ex) { ErrorResponse error = new ErrorResponse("404", "Resource not found"); return new ResponseEntity<>(error, HttpStatus.NOT_FOUND); }其中
ErrorResponse为自定义的错误响应对象。
RESTful API中的404处理
在RESTful服务中,404异常通常返回JSON格式的错误信息，建议统一异常响应格式，便于前端解析。
@RestControllerAdvice
public class ApiExceptionHandler {
@ExceptionHandler(NoHandlerFoundException.class)
public ResponseEntity<Map<String, Object>> handleApiNotFound(NoHandlerFoundException ex) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("timestamp", LocalDateTime.now());
body.put("status", HttpStatus.NOT_FOUND.value());
body.put("error", "Not Found");
body.put("message", ex.getRequestURL());
return new ResponseEntity<>(body, HttpStatus.NOT_FOUND);
}
}
最佳实践与注意事项
- 日志记录：捕获404异常时，需记录详细日志（如请求路径、IP、时间），便于排查问题。
- 区分业务异常：避免将业务逻辑错误（如查询结果为空）与404资源未找到混淆，后者应严格用于路径或资源不存在的情况。
- 性能优化：对于高频404请求（如恶意爬虫），可考虑直接拒绝响应或限制访问频率。
- 前端配合：前端应统一处理404错误，例如显示“页面不存在”提示，而非直接展示后端原始错误信息。
通过以上方法,开发者可以系统性地捕获和处理Java应用中的404异常，提升应用的稳定性和用户体验，关键在于结合框架特性，选择适合的异常处理策略，并注重日志记录与错误信息的规范化。
