0

0

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

煙雲

煙雲

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

|

835人浏览过

|

来源于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。

免费语音克隆
免费语音克隆

这是一个提供免费语音克隆服务的平台,用户只需上传或录制一段 5 秒以上的清晰语音样本,平台即可生成与用户声音高度一致的 AI 语音克隆。

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

HTTP 状态码 vs 异常类:别混淆 error-codeexception-type

web.xmlerror-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-INFMETA-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工具

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

173

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、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

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

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

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

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