讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

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

陌静大大_9215

陌静大大_9215

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

|

338人浏览过

|

来源于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.xml 的 web-app 根元素内,且要**在所有 servlet 和 servlet-mapping 之后**。放错位置(比如插在 servlet 中间)会导致整个 error-page 被容器忽略,连带其他配置也可能失效。

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

  • error-page 必须是 web-app 的直接子元素,不能嵌套在 servlet 或 filter 里
  • 多个 error-page 可共存,但 error-code 和 exception-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免费学习笔记(深入)”;

JavaScript 测试模式
JavaScript 测试模式

使用 Jest、Vitest 和 Testing Library 实施全面的测试策略,包括单元测试、集成测试和端到端测试,涵盖模拟、测试夹具和测试驱动开发。在编

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

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

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

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

  • 推荐同时配置: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-tomcat 是 provided 作用域,且打包方式为 war
Servlet 容器对 error-page 的匹配是静态的,不支持通配符或条件逻辑;一旦配置错误,失败表现非常安静——既不报错也不生效,这点最容易被忽略。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

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

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

965

2023.10.26

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

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

324

2024.02.23

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

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

509

2024.02.23

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

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

305

2024.02.23

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

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

348

2024.02.23

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

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

349

2024.02.23

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

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

601

2024.02.23

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

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

322

2024.02.23

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

40

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn