.NET 7中使用YARP反向代理时页面资源加载路径错误问题求助

这个问题我太熟悉了！你遇到的是YARP反向代理里很常见的静态资源路径解析问题——目标页面能正常加载，但页面里的脚本、样式、图片这些资源的请求地址都指向了你的代理服务器（localhost:5000），而非目标维基词典服务器。核心原因是目标页面返回的HTML里的资源引用多是相对路径，YARP默认不会自动重写这些路径，浏览器会把相对路径拼到当前域名下，自然找不到资源。

要解决这个问题，你只需要在路由配置里添加几个关键的Transforms（转换规则），让YARP帮你重写响应里的URL路径：

1. 修改appsettings.json配置 #

在你的反向代理路由配置中，补充Transforms节点，添加路径移除、Location头重写和HTML内容重写规则：

"ReverseProxy": {
  "Routes": {
    "wiki_route": {
      "ClusterId": "wiki_cluster",
      "Match": {
        "Path": "/wiki/{*any}"
      },
      "Transforms": [
        // 移除请求路径中的/wiki前缀，转发给目标服务器时路径正确
        { "PathRemovePrefix": "/wiki" },
        // 重写响应中的Location头，避免跳转直接指向目标域名
        { "RewriteLocationResponseHeader": "", "/wiki", "true" },
        // 开启HTML内容重写，自动修正页面里的所有资源引用路径
        { "HtmlRewrite": { "Enabled": true } }
      ]
    }
  },
  "Clusters": {
    "wiki_cluster": {
      "Destinations": {
        "wiki_dest": {
          "Address": "https://it.wiktionary.org/"
        }
      }
    }
  }
}

2. 每个转换规则的作用 #

• PathRemovePrefix: 把你请求的/wiki/prova里的/wiki前缀去掉，转发给目标服务器的路径就变成/prova，保证目标服务器能正确返回对应页面。
• RewriteLocationResponseHeader: 如果目标服务器返回跳转（比如3xx状态码），这个规则会把跳转地址里的根路径替换成/wiki前缀，避免浏览器直接跳转到目标域名。
• HtmlRewrite: 这是解决资源路径问题的核心！开启后YARP会自动解析目标页面返回的HTML内容，把里面的所有相对URL（比如<script src="/w/load.php">）重写成/wiki/w/load.php，这样浏览器就会请求你的代理服务器，再由代理转发到目标服务器，资源就能正常加载了。

3. 确认项目基础配置 #

如果你是ASP.NET Core项目，还要确保已经正确引用了YARP的NuGet包Microsoft.ReverseProxy，并且在Program.cs里正确注册了反向代理服务：

var builder = WebApplication.CreateBuilder(args);
// 注册反向代理服务并加载配置
builder.Services.AddReverseProxy()
    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));

var app = builder.Build();
// 映射反向代理路由
app.MapReverseProxy();
app.Run();

做完这些配置后，重启你的项目再访问localhost:5000/wiki/prova，页面里的脚本、样式等资源就会通过代理正确请求目标服务器了。

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