使用YARP反向代理至IIS WebForms服务器时遇到的问题

一、修复MIME类型丢失问题 #

• 检查YARP响应头转发配置：YARP默认会转发响应头，但如果路由配置了Transforms规则意外移除了Content-Type，需显式添加保留规则。在appsettings.json的路由配置中补充：

  "Transforms": [
    { "ResponseHeader": "Content-Type", "Preserve": true }
  ]
  

• 确认IIS端MIME映射完整性：检查IIS的web.config是否包含完整的静态资源MIME配置，避免源头缺失类型导致转发异常：

  <staticContent>
    <mimeMap fileExtension=".js" mimeType="application/javascript" />
    <mimeMap fileExtension=".css" mimeType="text/css" />
    <mimeMap fileExtension=".ico" mimeType="image/x-icon" />
  </staticContent>
  

二、处理静态路由重写与异常路由问题 #

• 在YARP端同步路径重写规则：针对IIS的/static-x.y.z转/static规则，在YARP路由中添加路径转换，避免客户端请求被错误转发：

  "Routes": [
    {
      "RouteId": "static-assets",
      "ClusterId": "aspnet-forms-cluster",
      "Match": {
        "Path": "/static-{version}/{**catch-all}"
      },
      "Transforms": [
        { "PathRemovePrefix": "/static-{version}" },
        { "PathPrefix": "/static" }
      ]
    }
  ]
  

• 单独配置favicon.ico路由：避免请求被路由到ASP.NET Forms默认页面，在YARP中添加专属路由规则：

  {
    "RouteId": "favicon",
    "ClusterId": "aspnet-forms-cluster",
    "Match": {
      "Path": "/favicon.ico"
    },
    "Transforms": [
      { "ResponseHeader": "Content-Type", "Preserve": true }
    ]
  }
  

  同时确认IIS端存在favicon.ico文件且MIME类型配置正确。

三、排查JavaScript依赖加载问题 #

• 修正页面相对路径解析：在ASP.NET Forms母版页中添加<base href="/" />标签，确保JS依赖的相对路径基于根路径解析，避免代理后路径错位。
• 检查依赖请求状态：用浏览器开发者工具查看JS依赖的请求状态，若出现404或MIME错误，需补充对应的YARP路由规则，确保请求能正确转发到IIS。
• 调整路由优先级：确保静态资源路由规则优先级高于ASP.NET Forms的动态页面路由，避免静态请求被错误导向动态页面。

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