0

0

Java Web web.xml error-page配置 自定义404和500错误页面

月夜之吻

月夜之吻

发布时间:2026-02-27 10:14:44

|

318人浏览过

|

来源于php中文网

原创

web.xml 中 error-page 不生效的主因是位置错误:必须作为 web-app 直接子元素且置于所有 servlet 和 servlet-mapping 之后;location 路径须以 / 开头、为上下文根下相对路径;捕获 500 异常需同时配置 error-code 和 exception-type(如 java.lang.runtimeexception);spring boot 项目默认忽略 web.xml,应改用 @controlleradvice 或 errorcontroller。

java web web.xml error-page配置 自定义404和500错误页面

web.xml 里 error-page 不生效?先看位置和顺序

必须放在 web.xmlweb-app 根元素内,且要**在所有 servletservlet-mapping 之后**。放错位置(比如插在 servlet 中间)会导致整个 error-page 被容器忽略,连带其他配置也可能失效。

常见错误现象:404 还是显示 Tomcat 默认页,500 报白板错误,但日志里没报 XML 解析异常——大概率是位置错了。

  • error-page 必须是 web-app 的直接子元素,不能嵌套在 servletfilter
  • 多个 error-page 可共存,但 error-codeexception-type 不能重复,否则后定义的会覆盖前一个
  • Tomcat 9+ 对 XML 顺序更严格,老项目迁移时容易在这里翻车

404 页面配了却进不去?检查路径是否为容器内相对路径

location 值不是文件系统路径,也不是 URL 路径,而是**Web 应用上下文根(context root)下的相对路径**,且必须以 / 开头,指向 WebContent 或 src/main/webapp 下的资源。

例如应用部署为 /myapp,想用 /errors/404.html,那 location 就写 /errors/404.html,而不是 ./errors/404.html/myapp/errors/404.html

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

提客AI提词器
提客AI提词器

「直播、录课」智能AI提词,搭配抖音直播伴侣、腾讯会议、钉钉、飞书、录课等软件等任意软件。

下载
  • 路径不以 / 开头 → 容器直接忽略该 error-page,无提示
  • 路径指向 JSP 时,确保该 JSP 没有抛出异常(比如 EL 表达式访问 null 对象),否则可能二次触发 500 而非显示你配的页面
  • 静态 HTML 最稳妥;若用 JSP,避免依赖未初始化的 request 属性或 session 数据

500 错误页面捕获不到 RuntimeException?别漏掉 exception-type

仅靠 error-code 配置 500,只能捕获 HTTP 状态码为 500 的响应,**不会拦截未处理的 Java 异常**。要真正兜住 NullPointerExceptionIllegalArgumentException 这类,必须额外配 exception-type

常见误区:以为配了 error-code500 就万事大吉,结果空指针还是打白板。

  • 推荐同时配置:error-code 捕获显式调用 response.sendError(500) 的场景;exception-type 捕获未 catch 的运行时异常
  • exception-type 值填完整类名,如 java.lang.RuntimeException,不能写 RuntimeException
  • 若想统一兜底所有异常,可写 java.lang.Throwable,但注意:部分容器对 Throwable 支持不一致,Tomcat 支持,Jetty 需确认版本

Spring Boot 项目里还写 web.xml?很可能根本没走它

Spring Boot 默认内嵌 Tomcat 并使用 Servlet 3.0+ 编程式配置,web.xml **完全被忽略**。此时配 error-page 是无效的。

真实生效的方式是:用 ErrorController 实现类,或配置 server.error.path + 静态资源 / 错误视图。

  • 判断依据:启动日志里没有 Parsing web.xml 相关输出,或者打断点发现 web.xml 根本没被加载
  • Spring Boot 2.3+ 推荐用 @ControllerAdvice + @ExceptionHandler 处理全局异常,比 XML 更灵活
  • 如果硬要保留 web.xml(比如 WAR 部署到外部 Tomcat),需确认 spring-boot-starter-tomcatprovided 作用域,且打包方式为 war
Servlet 容器对 error-page 的匹配是静态的,不支持通配符或条件逻辑;一旦配置错误,失败表现非常安静——既不报错也不生效,这点最容易被忽略。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能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服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

171

2024.02.23

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

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

98

2024.02.23

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

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

169

2024.02.23

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

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

156

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、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

243

2024.02.23

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

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

167

2024.02.23

html5播放器怎么用
html5播放器怎么用

本合集全面介绍HTML5播放器的使用方法,涵盖基础语法、自定义控制、兼容性处理及实战示例。阅读专题下面的文章了解更多详细内容。

0

2026.02.27

热门下载

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

精品课程

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

共23课时 | 3.9万人学习

C# 教程
C# 教程

共94课时 | 10.3万人学习

Java 教程
Java 教程

共578课时 | 73.3万人学习

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

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