讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Web.xml mime-mapping extension配置 MIME类型扩展名

胖芳小哥_1663

胖芳小哥_1663

发布时间:2026-02-20 09:29:02

|

1095人浏览过

|

来源于php中文网

原创

web.xml 的 mime-mapping 在 Tomcat 10+、Jetty 11+ 等新容器中默认不生效,因 Servlet 4.0+ 已弃用该配置,改由内置 MIME 表驱动;Spring Boot 内嵌容器默认禁用 web.xml 解析,且 jakarta 命名空间下可能被忽略。

web.xml mime-mapping extension配置 mime类型扩展名

web.xml 里 mime-mapping 不生效?先看容器是否还认这个配置

Tomcat 10+、Jetty 11+、WildFly 27+ 等新版本默认已弃用 web.xml 中的 mime-mapping,改由 Servlet 规范 4.0+ 的内置 MIME 映射表驱动。你配了但浏览器仍返回 application/octet-stream,大概率不是写错了,而是容器压根不读这一段。

  • Tomcat 9 及以下仍支持,但仅对未被内置映射覆盖的扩展名生效(比如 .xyz)
  • Spring Boot 内嵌 Tomcat 时,默认禁用 web.xml 解析,除非显式启用 ServletWebServerFactory.setRegisterJspServlet(true)
  • 若用 jakarta.servlet 命名空间(非 javax.servlet),mime-mapping 标签在部分容器中会被忽略——XML Schema 不匹配

extension 写错大小写或带点?浏览器和服务器都可能拒认

extension 值必须严格匹配请求路径中的后缀,且**不带开头的点**。写成 .js 或 JS 都无效;有些容器(如旧版 WebLogic)对大小写敏感,jpg 和 JPG 被视为不同扩展名。

  • 正确写法:<extension>js</extension>,不是
    <extension>.js</extension></li>
    <li>常见翻车:前端请求 <code>/static/chart.min.mjs
    ,但只配了 mjs,而某些容器要求完整匹配(min.mjs 不算 mjs)
  • 若需支持多级后缀(如 .tar.gz),标准 mime-mapping 无能为力,得靠 Filter 或 Servlet 动态设置 response.setContentType()

content-type 值写错格式?空格、分号、charset 都可能触发 fallback

mime-type 的值必须是合法的 MIME 字符串,且不能含多余空格或非法字符。写成 text/css ; charset=utf-8 或 application/json;charset=UTF-8 都会导致解析失败,容器退回到默认类型。

应用程序在线商店宣传网站模板
应用程序在线商店宣传网站模板

应用程序在线商店宣传网站模板是一款提供免费应用程序在线商店宣传网站模板下载。提示:本模板调用到谷歌字体库,可能会出现页面打开比较缓慢。

下载
  • 合法值示例:text/css、application/wasm、image/svg+xml
  • 非法值示例:text/css;charset=utf-8(mime-type 不接受参数,charset 应由响应头单独设)
  • 注意 XML 实体:若要写 application/xhtml+xml,直接写即可,不用转义 或 <code>>

静态资源走不到 web.xml?检查路径是否被 Spring MVC 或其他 Servlet 拦截

即使 mime-mapping 配得完全正确,如果请求被 DispatcherServlet 拦截(如 <url-pattern>/</url-pattern>),而你又没配置 <resources></resources> 或 WebMvcConfigurer.addResourceHandlers(),那根本不会走到容器默认的静态资源处理链,mime-mapping 自然没机会生效。

  • 验证方法:临时把 DispatcherServlet 的 url-pattern 改成 /api/*,再请求 /static/test.js,看是否返回正确 Content-Type
  • Spring Boot 用户更应优先用 spring.resources.chain.strategy.content.enabled=true + application.properties 中的 spring.web.resources.static-locations 控制行为
  • 纯 Servlet 容器(如 Tomcat standalone)下,确保文件放在 WEB-INF/classes 同级的 static/ 或根目录,而非 WEB-INF/ 内部

真正麻烦的从来不是怎么配,而是你以为配完了,其实请求根本没走那条路——查日志里的 Request Processing Chain,比对着 web.xml 盯十分钟更有用。

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

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

WorkBuddy

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

咔片AIPPT

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

豆包大模型

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

立刻MV
立刻MV Hot

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

墨刀AI
墨刀AI 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鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

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

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