Blazor WebAssembly：如何在web.config预置HTTP转HTTPS IIS重写规则

每次发布后web.config被覆盖、手动添加的规则丢失的核心原因，是VS的发布流程会自动在输出目录生成适配SPA运行的默认web.config，直接覆盖原有文件。完全可以在项目内预先配置重定向规则，让每次发布生成的web.config自动包含HTTP转HTTPS的逻辑，无需发布后手动修改。

方案一：项目内嵌完整自定义web.config（最稳定，优先推荐） #

VS发布Blazor WebAssembly时的默认web.config生成逻辑，不会覆盖项目根目录下标记为「始终复制」的自定义web.config，只要把所有必需的规则提前合并写入即可。
操作步骤：

• 在Blazor项目的根目录（而非wwwroot静态资源目录）添加web.config文件
• 先将VS默认自动生成的、保障SPA正常运行的基础规则（如SPA路由回退至index.html、静态文件MIME类型配置、目录浏览权限关闭等内容）完整写入该自定义文件
• 在文件的<system.webServer><rewrite><rules>节点下，将HTTP转HTTPS的重定向规则放在所有SPA路由规则的最前端，保证请求优先完成协议判断
• 选中项目中的该web.config文件，在属性面板中将「复制到输出目录」设置为始终复制，「生成操作」设置为内容

HTTP转HTTPS的标准URL Rewrite规则示例：

<rule name="HTTP to HTTPS Permanent Redirect" stopProcessing="true">
  <match url="(.*)" />
  <conditions>
    <add input="{HTTPS}" pattern="off" ignoreCase="true" />
  </conditions>
  <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
</rule>

方案二：通过MSBuild发布钩子自动合并规则（无需维护完整web.config） #

如果不想手动维护整套web.config的内容（避免VS后续更新默认生成规则时出现配置不一致），可以通过发布流程的钩子，在VS自动生成web.config后自动插入自定义的HTTPS跳转规则。
操作方式：

• 打开Blazor项目对应的.csproj文件
• 添加自定义发布目标，在VS完成默认web.config生成的阶段后，自动将预先写好的HTTPS重定向规则插入到web.config的对应节点中
• 可参考的目标配置片段：

<Target Name="InsertHttpsRedirectRule" AfterTargets="TransformWebConfig">
  <!-- 此处添加XML操作逻辑，从自动生成的web.config中定位rewrite规则节点，插入预置的HTTPS跳转规则 -->
</Target>

这种方式的优势是不需要跟踪VS默认生成的web.config内容，哪怕后续VS更新了SPA适配的默认规则，也不会丢失自定义的HTTPS跳转逻辑。

注意事项 #

• 自定义web.config文件必须放在发布目录的根层级（与index.html同级），不要放入wwwroot子目录，否则IIS无法识别到站点根目录的配置
• 配置生效的前提是目标IIS服务器已安装对应版本的URL Rewrite模块
• 生产环境建议将跳转规则的redirectType设置为Permanent（301状态码），减少不必要的重复请求；测试环境可临时使用Temporary（302状态码）避免浏览器缓存跳转规则

内容的提问来源于stack exchange，提问作者user2209634