Web.config system.webServer staticContent mimeMap IIS添加MIME类型

添加 mime 类型时需确保 mimetype 拼写正确、符合 rfc 规范，配置置于 下，避免重复声明，fileextension 统一小写，并注意 iis 版本差异与 ancm 干扰。

添加 MIME 类型时 mimeType 值写错导致文件下载而非渲染

常见现象是 HTML、js、CSS 或字体文件在浏览器里直接弹出下载，而不是正常执行或显示。根本原因往往是 mimeType 拼写错误（比如 text/javascrip 少了个 t），或用了非标准值（如 application/x-font-woff2 被写成 font/woff2）。IIS 对 mimeType 值大小写不敏感，但必须严格匹配 RFC 规范。

• mimeType 必须与客户端请求头中 Accept 和响应头中 Content-Type 一致，否则浏览器可能拒绝解析
• 常见正确值：text/html、application/javascript、text/css、font/woff2、image/svg+xml
• 不要用 application/octet-stream 代替未知类型——它会强制下载，且无法被缓存策略识别

staticContent 配置位置错误：放在 system.web 下无效

IIS 的静态内容配置只在 <system.webserver></system.webserver> 节点下生效，<system.web></system.web> 是 ASP.NET 运行时配置区，放在这里的 <staticcontent></staticcontent> 完全被忽略。很多开发者复制示例时没注意层级，结果加了等于没加。

• 正确路径：<configuration><system.webserver><staticcontent><mimemap ...></mimemap></staticcontent></system.webserver></configuration>
• 如果网站启用了 ASP.NET Core 模块（ANCM），还要确认是否由 IIS 处理静态文件——默认情况下 Core 应用会接管，此时 web.config 中的 staticContent 不起作用
• 修改后必须重启应用池或至少回收，仅刷新页面不会生效

重复添加同扩展名的 mimeMap 导致 500.19 错误

错误信息通常是：http Error 500.19 - internal Server Error / Cannot add duplicate Collection entry of type 'mimeMap' with unique key Attribute 'fileExtension' set to '.woff2'。IIS 默认已内置部分 MIME 类型（如 .css、.js），强行重复声明会冲突。

• 先检查是否已存在：%windir%system32inetsrvconfigapplicationHost.config 中的 <staticcontent></staticcontent> 节点
• 若要覆盖默认值（比如把 .json 从 application/json 改为 text/plain），必须先 <remove fileextension=".json"></remove>，再 <add ...></add>
• 推荐做法：只添加 IIS 默认未包含的类型（如 .webp、.avif、.mjs）

部署到不同 IIS 版本时 fileExtension 大小写敏感性差异

IIS 7–8.5 对 fileExtension 值不区分大小写（.SVG 和 .svg 视为同一项），但 IIS 10（windows Server 2016+）开始严格按字面匹配。如果开发环境是 IIS 8.5，上线到 IIS 10 后发现 .SVG 文件 404，大概率是扩展名大小写不一致。

• fileExtension 必须小写，这是微软官方文档隐含约定，也是各版本最稳妥的写法
• 前端引用资源时也建议统一用小写路径（logo.svg 而非 logo.SVG），避免跨平台或 CDN 缓存问题
• 检查实际请求 URL 中的扩展名，和 web.config 中写的是否完全一致（包括点号前有无空格）

事情说清了就结束。MIME 类型不是“加上就行”，关键在匹配、唯一性和环境一致性。最容易被忽略的是：本地测试通过 ≠ 上线可用，因为 IIS 版本、模块启用状态、甚至父级配置都会覆盖你的 web.config。