讲师中心 微信公众号
AI工具推荐 视频效率加速

Web.xml error-page location配置 自定义错误页面的路径

落萱姑娘_5170

落萱姑娘_5170

发布时间:2026-03-12 04:55:15

|

916人浏览过

|

来源于php中文网

原创

error-page 的 location 必须是以 / 开头、相对于 Web 应用根目录的路径,如 /errors/404.html;不支持 ../、协议前缀、EL 表达式或 Spring 视图解析,且文件需真实存在于部署后的 webapp 目录下。

web.xml error-page location配置 自定义错误页面的路径

error-page 的 location 必须是应用根路径下的相对路径

Web 容器(如 Tomcat)在解析 error-page 时,只接受以 / 开头、相对于 Web 应用根目录(即 webapp/ 目录)的路径。它不是文件系统路径,也不是类路径,更不支持 ../ 向上跳转或协议前缀。

  • location 值必须以 / 开头,比如 /errors/404.html,不能写成 errors/404.html 或 ./errors/404.html
  • 路径指向的是部署后实际可被 HTTP 访问的资源,所以要确保该文件真的放在 webapp/errors/404.html 下,而不是 src/main/webapp/ 下却忘了打包进去
  • 不支持 JSP EL、${} 占位符,也不能用 Spring 的视图解析器逻辑——这是 Servlet 规范层的纯静态转发
  • 如果用的是 WAR 包部署,路径区分大小写,/Errors/404.html 和 /errors/404.html 是两个不同资源

404 错误页面无法触发?检查是否被 Filter 或 Spring MVC 拦截了

常见现象:配置了 <error-page><error-code>404</error-code><location>/404.html</location></error-page>,但输入不存在路径时仍看到默认容器 404 页面,或跳到了 Spring 的 Whitelabel Error Page。

  • Spring Boot 默认启用了 ErrorMvcAutoConfiguration,会接管所有错误响应,导致 web.xml 的 error-page 失效
  • 普通 Spring MVC 项目中,如果 DispatcherServlet 的 <url-pattern>/</url-pattern> 覆盖了全部请求,而 404 实际发生在静态资源未命中时,部分容器(如旧版 Tomcat)可能不会触发 error-page,除非显式配置 default-servlet-handler
  • 自定义 Filter 如果没调用 chain.doFilter() 或吞掉了异常,也会中断错误传播链,让容器收不到原始错误信号

HTTP 状态码 vs 异常类:别混淆 error-code 和 exception-type

web.xml 中 error-page 支持两种匹配方式,行为和触发时机完全不同,混用会导致预期外的页面展示。

  • <error-code>500</error-code> 匹配的是响应已提交的状态码,比如 servlet 主动调用 response.sendError(500),或容器在处理请求时抛出未捕获异常后自动设的码
  • <exception-type>java.lang.NullPointerException</exception-type> 匹配的是未被捕获的 Java 异常类型,但前提是该异常**未被任何 filter 或 servlet catch 处理掉**,且容器能识别其类型
  • 同一个异常(如 NullPointerException)可能最终返回 500,但如果你只配了 error-code,没配 exception-type,就可能错过按异常类型定制页面的机会
  • 注意:exception-type 不支持通配符或父类向上匹配(比如配了 RuntimeException,不一定能捕获所有子类,取决于容器实现)

Tomcat 9+ 对 location 的额外限制:禁止访问 WEB-INF 和 META-INF

即使你在 location 里写了 /WEB-INF/jsp/error.jsp,Tomcat 9 及以后版本会直接拒绝并返回 404,这是安全加固措施,不是配置写错了。

  • 所有以 /WEB-INF/ 或 /META-INF/ 开头的 location 值都会被容器静默拦截,日志里可能只有类似 “Invalid error page location”的警告,没有明显报错
  • 解决办法:把 JSP 或 HTML 文件移到 webapp/ 直接子目录下,比如 /jsp/error.jsp,再在 location 中写对应路径
  • 如果必须用 WEB-INF 下的资源,只能改用程序内跳转(如 filter 中判断 status 后 request.getRequestDispatcher("/WEB-INF/jsp/error.jsp").forward()),但这绕过了 error-page 机制
实际调试时最容易卡住的点,是以为路径写对了,其实文件根本没进 WAR 包;或者在 Spring Boot 里白配了 web.xml,却忘了它默认不生效。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

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

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

码上飞
码上飞 Hot

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

豆包大模型

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

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

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

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

905

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

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

热门下载

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

精品课程

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

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