web.xml 的 mime-mapping 在 Tomcat 9+ 等 Servlet 4.0+ 容器中默认不生效，因 metadata-complete="true" 且 version≥4.0 时跳过解析；需设 metadata-complete="false" 或降级为 version="3.1"；Spring Boot 内嵌容器则完全忽略 web.xml，应改用 Java 配置注册 MIME 映射。

web.xml 里 mime-mapping 不生效？先确认服务器是否读取 web.xml

Tomcat 9+、Jetty 10+ 默认启用 Servlet 4.0+ 模式，web.xml 若声明了 version="4.0" 或更高，且未显式设置 metadata-complete="false"，容器会跳过 mime-mapping 解析——它只认注解和默认 MIME 映射。

• 检查 web.xml 根节点是否有 metadata-complete="false"（缺省值是 true）
• Tomcat 9+ 推荐用 web.xml 声明 version="3.1"，避免被当“完全注解驱动”忽略
• 若用 Spring Boot 内嵌 Tomcat，默认不加载 web.xml，mime-mapping 完全无效

怎么写一个有效的 mime-mapping？注意路径和大小写

mime-mapping 只影响静态资源的 Content-Type 响应头，不控制路由或权限；它匹配的是请求 URL 的**扩展名**，不是文件路径或内容。

• 扩展名必须带点，例如 .proto，不能写成 proto
• 扩展名区分大小写：浏览器请求 /a.PROTO 时，<extension>.proto</extension> 不会匹配
• <mimeType> 值要符合 RFC 规范，比如 application/x-protobuf 合法，protobuf 不合法

<mime-mapping>
  <extension>.proto</extension>
  <mimeType>application/x-protobuf</mimeType>
</mime-mapping>

为什么加了 mime-mapping，Chrome 还是下载而不是渲染？

浏览器是否渲染取决于两个条件同时满足：服务端返回正确的 Content-Type，且该类型在浏览器白名单内可执行/展示。很多自定义类型（如 text/x-sh、application/x-yaml）即使服务端设对了，Chrome 也强制下载。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• 常见“看起来没生效”的真实原因：浏览器策略拦截，不是服务端没发对头
• 用 curl -I http://localhost:8080/test.proto 确认响应头含 Content-Type: application/x-protobuf
• 若头正确但浏览器仍下载，说明该 MIME 类型未被浏览器识别为可 inline 渲染类型，换 text/plain 测试对比

替代方案：Spring Boot 项目别碰 web.xml

Spring Boot 2.5+ 默认禁用 web.xml，且内嵌容器不支持运行时解析其 mime-mapping。硬加配置只会被忽略。

立即学习“Java免费学习笔记（深入）”；

• 用 WebMvcConfigurer 注册 ResourceHttpRequestHandler 并调用 setMimeTypeResolvers()
• 更简单：在 application.properties 加 spring.resources.chain.strategy.content.enabled=true 不起作用——MIME 配置得走代码
• 最稳做法：改用 ResourceHandlerRegistry 手动注册路径，并指定 setCachePeriod() 和 setAllowedExtensions()，再通过 ContentNegotiationManager 补充 MIME 映射

有些服务器（比如 WildFly）会把 web.xml 里的 mime-mapping 当作部署时静态元数据，而 Tomcat 是运行时查表；同一段配置，在不同容器行为可能完全不同。别假设它“应该生效”。