1. 项目概述：为什么你的Unity WebGL在IIS上跑不起来？

如果你是一名Unity开发者，最近尝试把项目发布成WebGL版本，并且打算在Windows 11上用IIS（Internet Information Services）搭个本地或内网服务器来测试，那你大概率会遇到一个让人头疼的问题：页面白屏，控制台报一堆404或者MIME类型错误，尤其是那些带着.br后缀的文件。浏览器开发者工具的网络请求列表里，.data.br、.js.br、.wasm.br这几个文件可能根本加载不出来，或者被识别成了错误的类型。这感觉就像你组装了一台高性能电脑，结果因为一根电源线没插对，整个机器点不亮一样憋屈。

这个问题的根源，其实不在Unity，也不在你的代码，而在于IIS这个“老牌”的Web服务器。Unity WebGL为了减小包体、加快网络加载速度，默认会使用Brotli（.br）或Gzip（.gz）进行压缩。现代浏览器（如Chrome、Edge、Firefox）都原生支持解压这些格式，但前提是服务器在发送这些文件时，必须正确地告诉浏览器两件事：第一，这个文件的MIME类型是什么（比如.wasm.br本质上还是WebAssembly）；第二，这个文件是用什么压缩的（即Content-Encoding: br或gzip）。IIS默认配置里可没有这些.br后缀的映射规则，它不认识这些“新潮”的文件，要么拒绝服务，要么当成普通二进制文件乱发，浏览器自然就懵了，无法正确加载和初始化你的WebGL应用。

所以，这篇内容就是来解决这个“最后一公里”问题的。我将基于Win11环境，手把手带你从零开始，完成IIS的安装、配置，直到你的Unity WebGL应用完美运行。整个过程不涉及复杂的网络知识，你只需要跟着步骤操作，就能避开我当初踩过的所有坑。无论你是想本地快速测试，还是为团队搭建一个内部演示服务器，这套方法都适用。

2. 核心原理拆解：IIS、MIME类型与内容编码

在动手之前，我们花点时间搞清楚三个核心概念，这能让你彻底明白我们每一步配置的目的，以后遇到类似问题也能举一反三。

2.1 IIS的角色与静态内容处理

IIS是微软Windows系统内置的Web服务器软件。当浏览器请求一个文件（比如http://yoursite/Build/MyGame.wasm.br）时，IIS的工作流程是这样的：

1. 接收请求：解析请求的URL，找到对应的物理文件路径。
2. 查找处理程序：根据文件扩展名（如.br），决定由哪个模块来处理。对于静态文件（图片、JS、CSS等），通常由StaticFileModule处理。
3. 设置响应头：在发送文件内容之前，IIS会设置HTTP响应头。其中两个至关重要的头是：
   • Content-Type：告诉浏览器文件的MIME类型，例如application/javascript代表JavaScript文件。这个值由IIS中配置的“MIME类型”映射决定。
   • Content-Encoding：告诉浏览器文件内容是否被压缩，以及用何种算法压缩，例如br代表Brotli，gzip代表Gzip。
4. 发送文件：将文件内容以二进制流的形式发送给浏览器。

如果IIS在它的MIME类型数据库里找不到.br这个扩展名，它要么会拒绝访问（返回404.3错误），要么会用一个默认的MIME类型（如application/octet-stream）发送，并且不会自动添加Content-Encoding: br头。对于Unity压缩构建，浏览器必须同时知道正确的MIME类型和内容编码，才能成功解压并执行。

2.2 Unity WebGL的构建输出与压缩

当你使用Unity构建WebGL项目时（假设在Build Settings中选择了“Compression Format”为Brotli），会生成一个Build文件夹，里面通常包含以下关键文件：

• xxx.data.br：游戏资源数据文件，经过Brotli压缩。
• xxx.wasm.br：WebAssembly二进制代码文件，经过Brotli压缩。
• xxx.js.br：Unity WebGL加载器和运行时JavaScript代码，经过Brotli压缩。
• index.html：入口HTML页面。
• TemplateData文件夹：包含样式和图标等。

这里有一个关键点：这些.br文件，其“本质”仍然是.data、.wasm、.js文件，只是被Brotli算法压缩了。因此，我们需要告诉IIS：

1. .wasm.br文件的MIME类型应该是application/wasm（和未压缩的.wasm一样）。
2. .js.br文件的MIME类型应该是application/javascript。
3. .data.br和.symbols.json.br文件的MIME类型应该是application/octet-stream（通用的二进制流）。
4. 并且，所有以.br结尾的文件，其Content-Encoding响应头都应该设置为br。

2.3 配置的两种方式：静态内容 vs URL重写

根据Unity官方手册，配置IIS支持压缩构建主要有两部分，对应IIS配置的两个不同层面：

1. 静态内容（<staticContent>）：这部分负责MIME类型映射。我们在<staticContent>节点下，通过<mimeMap>元素，为.data.br、.wasm.br、.js.br等扩展名注册正确的MIME类型。这样IIS就知道该用什么Content-Type头来发送它们。

2. URL重写（<rewrite>）：这部分负责添加Content-Encoding响应头。我们需要用到IIS的“URL Rewrite”扩展模块。通过配置一个“出站规则（Outbound Rule）”，我们可以检查出站响应的文件名，如果匹配.br结尾，就在响应头里追加Content-Encoding: br。这是整个配置中最容易遗漏也最关键的一步，没有这个头，浏览器不会尝试解压Brotli格式。

注意：如果你的IIS服务器全局或站点级别启用了“静态内容压缩”，一定要在配置中将其禁用（<urlCompression doStaticCompression="false" />）。否则，一个已经压缩过的.br文件可能会被IIS再次用Gzip压缩，导致浏览器收到双重压缩的文件而无法识别。我们的配置里已经包含了这行。

3. 完整实操：Win11下IIS配置全流程

理论清楚了，我们开始实战。请严格按照步骤操作，我会在关键点说明原因和注意事项。

3.1 环境准备：启用IIS与必需模块

Win11默认没有安装IIS，我们需要手动开启这个功能。

1. 打开“启用或关闭Windows功能”：

   • 在开始菜单搜索“Windows 功能”，选择“启用或关闭Windows功能”。
   • 或者按Win + R，输入optionalfeatures并回车。

2. 安装IIS核心服务：

   • 在弹出的窗口中找到“Internet Information Services”，勾选它。
   • 展开它，确保以下子项被勾选（这是最精简的Web服务器配置）：
     • Web 管理工具->IIS 管理控制台（用于图形化管理）。
     • 万维网服务->应用程序开发功能->.NET Extensibility 3.5/4.8（如果项目涉及.NET，建议勾选）。
     • 万维网服务->常见HTTP功能->静态内容（必须勾选，用于托管HTML/JS等文件）。
     • 万维网服务->性能功能->静态内容压缩（建议先勾选，我们的配置会禁用它，但模块需要存在）。
   • 点击“确定”，系统会自动安装。完成后可能需要重启。

3. 验证IIS安装：

   • 安装完成后，打开浏览器，访问http://localhost。
   • 如果看到IIS的欢迎页面（通常显示“Internet Information Services”字样），说明安装成功。

3.2 获取并部署Unity WebGL构建文件

1. 构建你的Unity项目：

   • 在Unity编辑器中，打开File -> Build Settings。
   • 选择WebGL平台，点击Switch Platform。
   • 在“Compression Format”下拉框中，选择Brotli。为了演示配置，请确保选择这个。当然，Gzip的配置原理类似。
   • 点击Build，选择一个空文件夹（例如D:\MyWebGLGame）来存放构建输出。

2. 准备IIS站点目录：

   • 我习惯在非系统盘（如D盘）创建一个专门的目录来存放网站文件，例如D:\WebSites\MyUnityGame。
   • 将Unity构建输出的整个Build文件夹里的所有内容（包括index.html,.br文件,TemplateData文件夹），复制到D:\WebSites\MyUnityGame目录下。
   • 这样，你的index.html文件路径就是D:\WebSites\MyUnityGame\index.html。

3.3 创建IIS网站并设置物理路径

1. 打开IIS管理器：

   • 在开始菜单搜索“IIS”或“Internet Information Services (IIS)管理器”并打开。

2. 添加新网站：

   • 在左侧连接面板，展开你的服务器名，右键点击“网站”，选择“添加网站”。
   • 网站名称：填写一个易于识别的名字，如“MyUnityWebGL”。
   • 物理路径：点击浏览，选择你刚才准备好的目录D:\WebSites\MyUnityGame。务必确保路径正确，指向包含index.html的目录。
   • 绑定：
     • 类型：http
     • IP地址：默认“全部未分配”即可，表示监听本机所有IP。
     • 端口：可以保持默认的80，但如果80端口被占用（如已有其他网站），可以换一个不常用的，比如8080。这里我们假设用8080。
     • 主机名：本地测试可以留空。
   • 点击“确定”。

3. 设置默认文档：

   • 在IIS管理器左侧，点击你新建的网站“MyUnityWebGL”。
   • 在中间的功能视图里，找到并双击“默认文档”。
   • 确保列表中存在index.html。如果没有，点击右侧操作栏的“添加”，输入index.html。
   • 重要：将index.html上移到列表顶部。这样当访问网站根目录时，IIS会自动提供这个文件。

3.4 创建与配置web.config文件

这是解决.br文件问题的核心步骤。我们将在网站根目录创建一个名为web.config的XML配置文件。

1. 创建web.config文件：

   • 用记事本或任何代码编辑器（如VSCode）新建一个文件。
   • 将以下配置代码完整复制进去。这个配置集成了Unity官方推荐的设置，并包含了必要的注释。

   <?xml version="1.0" encoding="UTF-8"?> <configuration> <system.webServer> <!-- 关键设置1：禁用静态压缩。 原因：Unity构建的文件已经是Brotli压缩格式(.br)，如果IIS再次压缩，会导致双重压缩，浏览器无法识别。 --> <urlCompression doStaticCompression="false" /> <!-- 关键设置2：为压缩文件添加正确的MIME类型映射。 注意：先<remove>再<mimeMap>是为了避免与服务器上可能已存在的配置冲突。 --> <staticContent> <!-- 针对Brotli压缩文件(.br)的MIME类型设置 --> <remove fileExtension=".data.br" /> <mimeMap fileExtension=".data.br" mimeType="application/octet-stream" /> <remove fileExtension=".wasm.br" /> <mimeMap fileExtension=".wasm.br" mimeType="application/wasm" /> <remove fileExtension=".js.br" /> <mimeMap fileExtension=".js.br" mimeType="application/javascript" /> <remove fileExtension=".symbols.json.br" /> <mimeMap fileExtension=".symbols.json.br" mimeType="application/octet-stream" /> <!-- (可选) 如果你也使用Gzip压缩(.gz)，请取消以下注释 --> <!-- <remove fileExtension=".data.gz" /> <mimeMap fileExtension=".data.gz" mimeType="application/gzip" /> <remove fileExtension=".wasm.gz" /> <mimeMap fileExtension=".wasm.gz" mimeType="application/wasm" /> <remove fileExtension=".js.gz" /> <mimeMap fileExtension=".js.gz" mimeType="application/javascript" /> <remove fileExtension=".symbols.json.gz" /> <mimeMap fileExtension=".symbols.json.gz" mimeType="application/octet-stream" /> --> <!-- (可选但建议) 为未压缩的原始文件也添加MIME类型，以备不时之需 --> <remove fileExtension=".data" /> <mimeMap fileExtension=".data" mimeType="application/octet-stream" /> <remove fileExtension=".wasm" /> <mimeMap fileExtension=".wasm" mimeType="application/wasm" /> <remove fileExtension=".symbols.json" /> <mimeMap fileExtension=".symbols.json" mimeType="application/octet-stream" /> </staticContent> <!-- 关键设置3：为压缩文件添加Content-Encoding响应头。 注意：此部分需要IIS的“URL Rewrite”模块支持。 --> <rewrite> <outboundRules> <!-- 为.br文件添加'br'内容编码头 --> <rule name="Append brotli Content-Encoding header" preCondition="IsBrotli" patternSyntax="Wildcard"> <match serverVariable="RESPONSE_Content_Encoding" pattern="*" /> <action type="Rewrite" value="br" /> </rule> <!-- 定义匹配.br文件的条件 --> <preConditions> <preCondition name="IsBrotli"> <add input="{REQUEST_FILENAME}" pattern="*.br$" /> </preCondition> </preConditions> <!-- (可选) 如果你也使用Gzip压缩(.gz)，请取消以下注释 --> <!-- <rule name="Append gzip Content-Encoding header" preCondition="IsGzip" patternSyntax="Wildcard"> <match serverVariable="RESPONSE_Content_Encoding" pattern="*" /> <action type="Rewrite" value="gzip" /> </rule> <preConditions> <preCondition name="IsGzip"> <add input="{REQUEST_FILENAME}" pattern="*.gz$" /> </preCondition> </preConditions> --> </outboundRules> </rewrite> </system.webServer> </configuration>

2. 保存文件：

   • 将文件保存到你的网站根目录，即D:\WebSites\MyUnityGame\下，并确保文件名为web.config（注意没有.txt等后缀）。Windows记事本保存时，在“保存类型”里选择“所有文件(.)”，然后输入文件名web.config。

3.5 安装URL Rewrite模块

如果你的IIS还没有安装URL Rewrite模块，那么上一步配置中的<rewrite>节会导致IIS报错。我们需要安装它。

1. 下载URL Rewrite模块：

   • 访问微软官方下载页面：https://www.iis.net/downloads/microsoft/url-rewrite。通常下载URL Rewrite 2.1版本。
   • 根据你的系统架构（x64）下载安装程序。

2. 安装模块：

   • 运行下载的.msi安装程序，按照向导完成安装。
   • 安装完成后，需要重启IIS管理器（关闭再重新打开），或者重启“World Wide Web Publishing Service”服务，以使模块生效。

3. 验证安装：

   • 重新打开IIS管理器，点击左侧的服务器节点（你的电脑名）。
   • 在中间的功能视图里，找到“模块”图标并双击。
   • 在列表里如果能找到RewriteModule或UrlRewriteModule，说明安装成功。

3.6 测试与验证配置

所有配置完成后，让我们来验证一下。

1. 启动网站并访问：

   • 在IIS管理器中，确保你的“MyUnityWebGL”网站是启动状态（右侧操作栏有“停止”按钮）。
   • 打开浏览器，访问http://localhost:8080（如果你用了其他端口，请替换端口号）。
   • 理想情况下，你应该能看到你的Unity WebGL游戏开始加载并运行。

2. 使用浏览器开发者工具排查：

   • 如果页面白屏，按F12打开开发者工具，切换到“网络(Network)”标签页。
   • 刷新页面(Ctrl+R)，观察所有网络请求。
   • 关键检查点：
     • 状态码：所有.br文件的请求状态应该是200 OK或304 Not Modified。如果是404，检查物理路径；如果是404.3，说明MIME类型问题，检查web.config语法和路径。
     • 响应头：点击任意一个.br文件（如xxx.wasm.br）的请求，查看响应头(Response Headers)。
       • 必须包含Content-Type: application/wasm（对于.wasm.br）。
       • 必须包含Content-Encoding: br。这是成功的关键！如果没有这个头，说明URL重写规则没生效，请检查URL Rewrite模块是否安装，以及web.config中<rewrite>节的语法。
     • 控制台(Console)：查看是否有红色的JavaScript错误。常见的错误信息会提示文件加载失败或MIME类型不正确。

4. 常见问题排查与深度优化技巧

即使按照步骤操作，也可能因为环境差异遇到问题。这里是我总结的常见坑点和解决方案。

4.1 典型错误与解决方案速查表

4.2 高级配置与优化心得

1. 针对Gzip压缩的配置：如果你在Unity构建时选择了Gzip，只需将web.config中注释掉的Gzip相关部分（<!-- ... -->内的<mimeMap>和<rule>）取消注释即可。注意，Gzip的MIME类型为了兼容Safari，.data.gz通常也设置为application/gzip。

2. 部署到子目录或虚拟目录：如果你的WebGL构建不是放在网站根目录，而是子目录（如http://localhost/MyGame/），你需要确保web.config文件也放在那个子目录下。IIS的配置是层级继承的，子目录下的web.config会覆盖或合并父目录的配置。

3. 使用应用程序池的“无托管代码”模式：对于纯静态的WebGL站点，在IIS中为网站分配一个专用的应用程序池，并将其“.NET CLR 版本”设置为“无托管代码”。这可以减少不必要的.NET运行时开销，让IIS更专注于静态文件服务。

4. 启用静态内容缓存：在IIS中，可以为静态文件（如.js.br,.wasm.br）设置客户端缓存策略，减少重复请求。在网站或服务器的“HTTP响应头”功能中，可以设置“设置常用标头”来启用过期时间。不过要小心，更新游戏版本后需要处理缓存失效问题（通常通过修改文件名或查询参数实现）。

5. 关于application/octet-stream：对于.data.br和.symbols.json.br，我们将其MIME类型设置为application/octet-stream（通用二进制流）。这是安全的，因为Unity的加载器（那个.js文件）会负责处理这些数据文件，浏览器不需要直接解析它们。不要尝试设置为application/json等，这可能导致浏览器行为异常。

5. 从原理到实践的避坑指南

回顾整个过程，最核心的陷阱其实就两个：MIME类型和内容编码头。IIS作为一个通用的、历史悠久的服务器，不会预知所有新兴的文件格式和压缩方案。我们的web.config本质上就是一份给IIS的“说明书”，告诉它：“嘿，以后看到以.br结尾的文件，请把它当成某种特定类型（MIME），并且告诉浏览器这是用Brotli压过的（Content-Encoding）。”

我遇到过最常见的情况是，开发者只配置了MIME类型，忘了装URL Rewrite模块来加内容编码头。结果就是，浏览器收到了文件，也知道它是WebAssembly（因为Content-Type对了），但就是不解压，导致二进制格式错误，WebGL运行时初始化失败。所以，请务必把安装URL Rewrite模块作为必选项。

另一个容易忽略的点是配置文件的位置和语法。web.config必须放在你网站内容（即index.html所在目录）的根目录。它的语法是严格的XML，一个多余的空格或一个未闭合的标签都可能导致整个站点报500错误。建议使用VSCode、Notepad++等有语法高亮的编辑器来编写和检查，它们能帮你快速发现明显的格式错误。

最后，浏览器的开发者工具（F12）是你最好的朋友。任何部署问题，首先看“网络”标签，观察文件的请求和响应。状态码告诉你文件找没找到，响应头告诉你服务器是怎么描述这个文件的。结合控制台的错误信息，几乎能定位99%的配置问题。养成一有问题就按F12的习惯，能节省大量盲目猜测的时间。