ASP.NET MVC添加MP4 MIME映射后本地静态资源无法加载的问题

问题原因 #

直接在web.config中添加<staticContent>节点时，会覆盖IIS（包括本地IIS Express）继承的默认静态资源MIME映射，导致除MP4外的其他静态资源（如CSS、JS、图片等）丢失对应的MIME类型，因此本地运行时所有静态资源无法加载；而应用服务上需要显式配置MP4的MIME映射才能正常播放视频，所以出现了“配置留着本地崩，注释掉生产崩”的矛盾。

解决方案 #

方案1：保留默认MIME映射的同时添加MP4配置 #

修改web.config中的<staticContent>配置，先移除已存在的MP4映射（避免重复配置冲突），再添加目标映射，这样不会覆盖其他默认的MIME配置：

<system.webServer>
  <!-- 其他配置 -->
  <staticContent>
    <remove fileExtension=".mp4" />
    <mimeMap fileExtension=".mp4" mimeType="video/mp4" />
  </staticContent>
</system.webServer>

这种方式既保证应用服务能识别MP4视频，又不会破坏本地IIS Express的默认静态资源MIME映射，本地和生产环境都能正常运行。

方案2：使用Web.config变换区分环境 #

如果希望本地和生产环境使用不同的配置，可利用Web.config变换功能：

1. 主web.config中不添加MP4的MIME配置（保持本地开发正常）
2. 创建Web.Release.config（发布到生产环境时自动应用），添加如下变换代码：

<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <system.webServer>
    <staticContent xdt:Transform="Insert">
      <mimeMap fileExtension=".mp4" mimeType="video/mp4" />
    </staticContent>
  </system.webServer>
</configuration>

发布应用服务时，该变换会自动将MP4的MIME映射插入到生产环境的web.config中，本地开发不受影响。

内容的提问来源于stack exchange，提问作者Red-Dot