0

0

Java Web web.xml servlet-mapping配置 URL路径映射规则

畫卷琴夢

畫卷琴夢

发布时间:2026-02-27 08:34:03

|

280人浏览过

|

来源于php中文网

原创

web.xml中servlet-mapping路径匹配严格按优先级:精确匹配>前缀匹配(/xxx/)>扩展名匹配(.xxx)>默认匹配(/);/与/*完全不同,前者为默认servlet,后者覆盖全部导致静态资源404;注解与xml配置互斥,须统一使用一种方式。

java web web.xml servlet-mapping配置 url路径映射规则

web.xml 中 servlet-mapping 的路径匹配到底怎么写才生效

不加斜杠、加斜杠、带星号,三种写法行为完全不同,不是“差不多能用”——写错就 404 或全拦住。

关键看两点:是否以 / 开头、结尾是否有 *。容器按「精确匹配 → 前缀匹配(/xxx/*)→ 扩展名匹配(*.xxx)→ 默认匹配(/)」顺序找,只取第一个命中项。

  • <url-pattern>/api</url-pattern>:只匹配 /api,不匹配 /api//api/users
  • <url-pattern>/api/*</url-pattern>:匹配 /api/api//api/users/api/v1/anything,但注意:request.getServletPath() 截到 /api,后面是 getPathInfo()
  • <url-pattern>*.do</url-pattern>:匹配任意路径下以 .do 结尾的请求,如 /user/login.do,但不能写成 /xxx/*.do —— 扩展名匹配不允许路径前缀

为什么 //* 看起来像却完全不是一回事

/ 是“默认 Servlet”,处理所有没被其他 pattern 拦下的请求(比如静态资源),而 /* 是“覆盖全部”,连 .jsp/favicon.ico 都会进你的 Servlet —— 这是线上最常导致静态资源打不开或 JSP 不解析的元凶。

典型翻车现场:<url-pattern>/*</url-pattern> 配给 Spring DispatcherServlet,结果 CSS/JS 404,JSP 直接下载。

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

FineCam
FineCam

FineShare平台的推出的AI虚拟摄像头,可以将任何摄像头转换为高质量的网络摄像头

下载
  • 想让 Servlet 处理所有路径但保留静态资源?别用 /*,改用 /app/* + 前端路由或反向代理剥离
  • 真要接管全部?确保你自己能处理 GET /favicon.icoHEAD /health 这类探测请求
  • Tomcat 9+ 对 /* 的处理更严格,某些情况会直接拒绝部署

多个 servlet-mapping 共存时谁优先

不是按 XML 里写的顺序,而是严格按规范定义的匹配优先级:精确 > 前缀 > 扩展名 > 默认。哪怕你把 *.html 写在最上面,只要有个 /user/profile 精确匹配,它就永远先中。

常见误判:<url-pattern>/user/*</url-pattern><url-pattern>/user/login.html</url-pattern> 同时存在,后者永远不会触发 —— 因为 /user/login.html 先被前缀匹配吃掉了。

  • 扩展名匹配(*.jsp)和前缀匹配(/admin/*)冲突时,前缀赢
  • 两个前缀匹配,长的优先:/api/v2/*/api/* 优先
  • 完全一样的 pattern,不同 servlet,容器行为未定义,别这么干

Servlet 3.0+ 注解方式下,web.xml 还要不要配 servlet-mapping

如果用了 @WebServlet(urlPatterns = "/api"),且没有设置 metadata-complete="true",web.xml 里的 mapping 就会被忽略 —— 但反过来,如果 web.xml 里写了 mapping,注解就失效了。

混合使用极易失控:比如注解写了 @WebServlet("/v1/*"),web.xml 又配了个 /v1/user,结果只有 web.xml 生效,你还以为注解漏写了。

  • 二选一:纯注解就删掉 web.xml 中所有 servletservlet-mapping;纯 XML 就删掉所有 @WebServlet
  • 想保留 web.xml 做环境差异化配置?把注解全去掉,统一收口
  • Spring Boot 默认禁用 web.xml,spring.mvc.servlet.path 控制的是 DispatcherServlet 的 base path,和这里不是同一层

路径映射看着简单,实际是请求入口的闸门。一个斜杠位置不对,整个流量就拐错了弯,而且问题往往不报错,只静默失效。

热门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

Golang 实际项目案例:从需求到上线
Golang 实际项目案例:从需求到上线

《Golang 实际项目案例:从需求到上线》以真实业务场景为主线,完整覆盖需求分析、架构设计、模块拆分、编码实现、性能优化与部署上线全过程,强调工程规范与实践决策,帮助开发者打通从技术实现到系统交付的关键路径,提升独立完成 Go 项目的综合能力。

1

2026.02.26

热门下载

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

精品课程

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

共23课时 | 3.9万人学习

C# 教程
C# 教程

共94课时 | 10.3万人学习

Java 教程
Java 教程

共578课时 | 73.2万人学习

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

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