ASP.NET Core多环境域名跨应用同前缀跳转实现方案咨询

核心思路 #

从当前cmsSite的主机名中提取环境前缀（如qa1/qa2/qa3），将其替换到exampleApp的主机模板中，实现环境的一一对应匹配。以下提供两种场景的具体实现：

场景1：从源头生成正确链接（推荐，无需跳转） #

如果页面中的exampleApp链接是可控的，直接生成对应环境的目标地址，避免额外跳转请求，体验更流畅。

步骤1：在appsettings.json配置模板 #

"AppLinkTemplates": {
  "ExampleAppHost": "{environment}.exampleApp.com",
  "CmsSiteDomainSuffix": "cmsSite.com"
}

步骤2：编写HtmlHelper扩展方法 #

在项目中创建扩展类，用于在视图中生成动态链接：

using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.Extensions.Configuration;
using System;

public static class HtmlHelperExtensions
{
    public static IHtmlContent ExampleAppLink(this IHtmlHelper htmlHelper, string linkText, string path = "")
    {
        var host = htmlHelper.ViewContext.HttpContext.Request.Host.Host;
        var config = htmlHelper.ViewContext.HttpContext.RequestServices.GetRequiredService<IConfiguration>();
        
        // 用正则提取环境前缀（比按.分割更严谨，避免非QA环境误匹配）
        var prefixMatch = System.Text.RegularExpressions.Regex.Match(host, @"^(qa\d+)\." + config["AppLinkTemplates:CmsSiteDomainSuffix"] + "$");
        if (!prefixMatch.Success)
        {
            // 匹配失败时跳转到默认环境，比如qa1
            return htmlHelper.ActionLink(linkText, "", "", null, null, "qa1.exampleApp.com", path, null, null);
        }

        var environmentPrefix = prefixMatch.Groups[1].Value;
        var targetHost = string.Format(config["AppLinkTemplates:ExampleAppHost"], environmentPrefix);
        var targetUrl = new UriBuilder("https", targetHost) { Path = path }.ToString();

        return htmlHelper.ActionLink(linkText, "", "", null, null, targetHost, path, null, null);
    }
}

步骤3：在视图中使用 #

直接调用扩展方法生成对应环境的链接：

@Html.ExampleAppLink("打开内部应用", "/dashboard")

场景2：中间件处理固定链接跳转（适配数据库中已有的固定链接） #

如果数据库中存储的exampleApp链接是固定地址（如exampleApp.com），需要通过中间件拦截请求并重定向到对应环境。

步骤1：在appsettings.json配置规则 #

"RedirectRules": {
  "ExampleAppTriggerPath": "/redirect-to-exampleapp",
  "TargetHostTemplate": "{environment}.exampleApp.com",
  "CmsSiteDomainPattern": @"^(qa\d+)\.cmsSite\.com$"
}

步骤2：编写环境跳转中间件 #

using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using System.Text.RegularExpressions;
using System.Threading.Tasks;

public class EnvironmentRedirectMiddleware
{
    private readonly RequestDelegate _next;
    private readonly IConfiguration _config;
    private readonly Regex _cmsSiteRegex;

    public EnvironmentRedirectMiddleware(RequestDelegate next, IConfiguration config)
    {
        _next = next;
        _config = config;
        _cmsSiteRegex = new Regex(config["RedirectRules:CmsSiteDomainPattern"], RegexOptions.Compiled);
    }

    public async Task InvokeAsync(HttpContext context)
    {
        var request = context.Request;
        
        // 拦截指定的跳转触发路径
        if (request.Path.StartsWithSegments(_config["RedirectRules:ExampleAppTriggerPath"]))
        {
            var host = request.Host.Host;
            var match = _cmsSiteRegex.Match(host);
            
            if (match.Success)
            {
                var environment = match.Groups[1].Value;
                var targetHost = string.Format(_config["RedirectRules:TargetHostTemplate"], environment);
                var targetPath = request.Query["path"].ToString() ?? "/";
                var targetUrl = $"https://{targetHost}{targetPath}";

                // 使用临时跳转（302）：QA环境可能变动，永久跳转（301）会被浏览器缓存，不利于后续调整
                context.Response.Redirect(targetUrl, permanent: false);
                return;
            }
        }

        await _next(context);
    }
}

步骤3：注册中间件（.NET 6+在Program.cs，旧版在Startup.cs） #

// Program.cs中
var app = builder.Build();

// 在UseRouting之后、UseEndpoints之前注册中间件
app.UseMiddleware<EnvironmentRedirectMiddleware>();

// 后续中间件...
app.UseAuthorization();
app.MapControllers();
app.Run();

针对你的疑问解答 #

1. 重写 vs 重定向：跨域名场景下无法使用URL重写（重写是服务器内部转发，仅限同域名/应用），因此只能用重定向；如果能从源头生成正确链接，完全不需要跳转操作。
2. 扩展方法 vs 中间件：扩展方法适合主动生成正确链接，从根源解决问题；中间件适合被动处理已存在的固定链接，作为补救方案。
3. 永久（301）vs 临时（302）跳转：优先用302临时跳转，QA环境属于测试环境，可能会有变动，301永久跳转的缓存特性会导致浏览器记住旧地址，不利于后续调整。
4. 正则表达式：推荐使用正则提取环境前缀，比按.分割更严谨，能避免非QA环境（如dev.cmsSite.com）的误匹配，同时兼容qa1/qa10等多位数的环境命名。

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