讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

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

冬杰小哥_9689

冬杰小哥_9689

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

|

380人浏览过

|

来源于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免费学习笔记(深入)”;

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

下载
  • 想让 Servlet 处理所有路径但保留静态资源?别用 /*,改用 /app/* + 前端路由或反向代理剥离
  • 真要接管全部?确保你自己能处理 GET /favicon.ico 和 HEAD /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 中所有 servlet 和 servlet-mapping;纯 XML 就删掉所有 @WebServlet
  • 想保留 web.xml 做环境差异化配置?把注解全去掉,统一收口
  • Spring Boot 默认禁用 web.xml,spring.mvc.servlet.path 控制的是 DispatcherServlet 的 base path,和这里不是同一层

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

热门AI工具

更多
UP简历
UP简历 Hot

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

豆包大模型

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

SkildArt
SkildArt Hot

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

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

码上飞
码上飞 Hot

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

DeepSeek

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

VibeKnow
VibeKnow Hot

一款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