Java配置404和500错误跳转指南

本文深入解析了Java Web应用中处理404和500错误页面跳转的完整方案，既涵盖传统Servlet容器下web.xml的规范配置要点（强调位置、路径格式及常见陷阱），也系统梳理了Spring Boot环境下的现代实践——摒弃过时的web.xml依赖，转而通过ErrorController、定制BasicErrorController、合理使用@ControllerAdvice与全局异常处理器实现全链路错误兜底；同时直击JSP路径失效、容器禁用JSP、静态资源404被MVC拦截、前后端分离下JSON错误响应冲突等高频痛点，并提醒开发者关注Filter层异常等易被忽略的“盲区”，为不同架构场景提供精准、可靠、可落地的错误处理策略。

web.xml里怎么配404和500跳转页面

直接在web.xml的根节点下加块就行，这是最稳妥、全容器兼容的方式。Servlet 2.4+都支持，Tomcat、Jetty、WebLogic都能认。

常见错误是把写在或里面——它必须是的直接子元素。

• 404 + /error/404.jsp：路径必须以/开头，且是相对于Web应用根目录（不是类路径）
• javax.servlet.ServletException也能捕获未处理异常，但不如500码通用，部分容器对它的支持不一致
• 如果同时配了500和java.lang.Throwable，优先匹配更具体的500码

Spring Boot里用配置类替代web.xml

Spring Boot默认不加载web.xml，得用@ControllerAdvice或ErrorController接管。别试图在application.properties里配404跳转——它只管Spring MVC层的异常，对静态资源404、Filter抛出的异常、容器级错误统统无效。

真正能兜住所有500的，是实现ErrorController接口；而404要靠server.error.whitelabel.enabled=false关掉白页，再配合BasicErrorController的定制逻辑。

• 继承BasicErrorController时，重写errorHtml()方法，用request.getAttribute("javax.servlet.error.status_code")判断状态码
• 别在@ExceptionHandler里返回ModelAndView("error/500")就以为完事了——它只捕获Controller层抛出的异常，Filter里new RuntimeException()或异步线程里的异常根本进不来
• 如果用了WebMvcConfigurer自定义SimpleMappingExceptionResolver，注意它已被Spring Boot 2.3+标记为过时，优先走ErrorController

为什么/error/404.jsp访问不到或报404

页面路径配对了，但浏览器还是看到默认容器错误页，大概率是资源没放对位置，或者被Spring MVC拦截了。

常见问题集中在路径解析和请求链路上：

• JSP文件必须放在src/main/webapp/error/404.jsp（Maven结构），不是src/main/resources或src/main/java
• 如果用了Spring Boot + Spring MVC，且spring.mvc.throw-exception-if-no-handler-found=true，静态资源404会被转成NoHandlerFoundException，此时web.xml的404配置完全失效
• Tomcat 9+默认禁用JSP支持，若没引入tomcat-jasper依赖，/error/404.jsp会直接返回空白或500
• 用IDEA运行时，检查Project Structure → Artifacts是否把webapp目录标记为“Web Resource Directory”

前后端分离项目要不要配这些

要，但目的变了：不是为了跳转HTML页面，而是统一返回JSON格式错误响应，避免前端拿到HTML内容后解析失败。

这时候web.xml的反而容易坏事——它会把原本该返回JSON的500响应，强行替换成JSP渲染的HTML。

• 推荐关掉web.xml的错误页配置，改用全局异常处理器返回ResponseEntity>
• 对404，Spring Boot可通过server.error.path=/api/error指定错误入口，再由Controller统一输出{"code":404,"msg":"Not Found"}
• 注意Nginx或前端路由可能拦截404，导致请求根本到不了后端，这种情况下后端配置再全也没用

最麻烦的是Filter里抛异常又没被Spring管理的场景——比如自定义Shiro Filter里throw new UnauthorizedException()，既不会进@ControllerAdvice，也不触发web.xml的500配置，只能靠Filter自身try-catch兜底。这点很容易被忽略。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。