添加 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%\system32\inetsrv\config\applicationHost.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。
