ASP.NET中Html.ActionLink生成APIM自定义URL问题求助

一、全局配置（推荐，一劳永逸） #

Html.ActionLink生成URL时依赖请求上下文的基础地址，要让它适配APIM的访问路径，核心是让Web应用识别APIM的前置地址，有两种可靠方式：

1. 通过APIM转发请求头+Web应用中间件适配 #

在APIM的目标API入站策略中添加以下配置，把APIM的访问地址信息传递给后端Web应用：

<set-header name="X-Forwarded-Proto" exists-action="override">
    <value>@(context.Request.OriginalUrl.Scheme)</value>
</set-header>
<set-header name="X-Forwarded-Host" exists-action="override">
    <value>@(context.Request.OriginalUrl.Host)</value>
</set-header>
<set-header name="X-Forwarded-PathBase" exists-action="override">
    <value>/examplewebapp</value>
</set-header>

然后根据Web应用的.NET版本配置中间件，读取这些请求头来修正上下文的基础地址：

.NET Core 示例（Startup.cs）

在Configure方法中添加：

// 处理转发的协议、主机头
app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto | ForwardedHeaders.XForwardedHost
});

// 处理APIM的路径前缀
app.Use((context, next) =>
{
    var pathBase = context.Request.Headers["X-Forwarded-PathBase"].FirstOrDefault();
    if (!string.IsNullOrEmpty(pathBase))
    {
        context.Request.PathBase = new PathString(pathBase);
    }
    return next();
});

.NET Framework 示例（Global.asax）

在Application_BeginRequest方法中添加：

protected void Application_BeginRequest()
{
    var forwardedHost = Request.Headers["X-Forwarded-Host"];
    var forwardedProto = Request.Headers["X-Forwarded-Proto"];
    var forwardedPathBase = Request.Headers["X-Forwarded-PathBase"];

    if (!string.IsNullOrEmpty(forwardedHost))
    {
        Request.Url = new UriBuilder(forwardedProto ?? Request.Url.Scheme, forwardedHost)
        {
            Path = forwardedPathBase + Request.Url.PathAndQuery,
            Port = forwardedProto == "https" ? 443 : 80
        }.Uri;
    }
}

配置完成后，Html.ActionLink会自动基于APIM的地址生成正确的URL，无需修改页面代码。

2. 硬编码全局PathBase（灵活性差，不推荐） #

如果不需要Web应用支持直接访问，可直接在Web应用中全局指定路径前缀：

.NET Core（Startup.cs）

app.UsePathBase("/examplewebapp");

.NET Framework（Global.asax）

RouteTable.Routes.RouteExistingFiles = true;
RouteTable.Routes.MapRoute(
    name: "Default",
    url: "examplewebapp/{controller}/{action}/{id}",
    defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
);

这种方式的缺陷是无法同时支持Web应用的直接访问和APIM访问，仅适合单一访问场景。

二、局部修改链接（适合个别页面） #

如果只需要调整少量页面的链接，可直接使用Html.ActionLink的重载或手动拼接URL：

// 方式1：修正ActionLink生成的地址
@Html.ActionLink("首页", "Index", "Home", null, new { 
    href = Url.Action("Index", "Home", null, Request.Url.Scheme)
        .Replace(Request.Url.Authority, "somedomain.com")
        .Insert(8, "/examplewebapp")
})

// 方式2：直接拼接完整URL
<a href="https://somedomain.com/examplewebapp/@Url.Action("Index", "Home")">首页</a>

这种方式维护成本较高，不适合大面积使用。

三、验证APIM配置 #

最后确认APIM的基础配置是否正确：

• 进入目标API的「设置」页面，确认「URL后缀」已设置为examplewebapp
• 检查入站策略，确保没有<rewrite-url>等操作意外移除路径前缀

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