0

0

如何在Java Web项目中配置404与500异常跳转_web.xml与配置类设置

P粉602998670

P粉602998670

发布时间:2026-03-14 14:00:04

|

462人浏览过

|

来源于php中文网

原创

在web.xml中配置404和500跳转页面需将<error-page>作为<web-app>直接子元素,配合<error-code>和<location>(路径以/开头、相对于Web根目录);Spring Boot中应使用ErrorController替代web.xml,避免JSP路径错误、容器禁用JSP或Spring MVC拦截导致失效。

如何在java web项目中配置404与500异常跳转_web.xml与配置类设置

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

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

常见错误是把<error-page>写在<servlet><filter>里面——它必须是<web-app>的直接子元素。

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

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

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

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

立即学习Java免费学习笔记(深入)”;

  • 继承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拦截了。

Napkin AI
Napkin AI

Napkin AI 可以将您的文本转换为图表、流程图、信息图、思维导图视觉效果,以便快速有效地分享您的想法。

下载

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

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

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

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

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

  • 推荐关掉web.xml的错误页配置,改用全局异常处理器返回ResponseEntity<Map<String, Object>>
  • 对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.xml500配置,只能靠Filter自身try-catch兜底。这点很容易被忽略。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

117

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

173

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

99

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

170

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

158

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

200

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

169

2024.02.23

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.3万人学习

Java 教程
Java 教程

共578课时 | 82.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号