ASP.NET Core中强制所有Url携带指定查询参数的实现方案

当然有办法实现这个需求！我之前做项目的时候刚好碰到过类似的场景，下面给你两种实用的实现思路，你可以根据项目情况选择：

方案一：封装UrlHelper扩展方法（简单直接，可控性强） #

这种方法需要你稍微修改现有生成URL的代码，但好处是可以精准控制哪些链接需要自动带参数，哪些不需要。

首先创建一个UrlHelper的扩展类：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Routing;

public static class UrlHelperPersistentParamExtensions
{
    // 封装RouteUrl方法，自动添加持久化参数
    public static string PersistentRouteUrl(this IUrlHelper urlHelper, string routeName, object routeValues = null)
    {
        // 从当前请求中获取要持久化的参数（支持QueryString或路由参数）
        var httpContext = urlHelper.ActionContext.HttpContext;
        var myParamValue = httpContext.Request.RouteValues["myparam"]?.ToString() 
                           ?? httpContext.Request.Query["myparam"].FirstOrDefault();

        // 合并原有路由值和持久化参数
        var routeValueDict = new RouteValueDictionary(routeValues);
        if (!string.IsNullOrEmpty(myParamValue))
        {
            // 如果原有路由值里已经指定了myparam，就用原有值覆盖
            if (!routeValueDict.ContainsKey("myparam"))
            {
                routeValueDict["myparam"] = myParamValue;
            }
        }

        return urlHelper.RouteUrl(routeName, routeValueDict);
    }
}

之后把你原来的Url.RouteUrl("MyRoute", new {myparam = 1})替换成Url.PersistentRouteUrl("MyRoute")就可以了：

• 当当前请求URL包含myparam参数时，生成的所有链接都会自动带上该参数
• 如果原有路由值里显式指定了myparam，会优先使用你指定的值
• 没有myparam参数时，生成的URL也不会包含它

方案二：自定义RouteValueProvider（全局生效，无需修改现有代码） #

如果你不想改动现有任何生成URL的代码，希望全局自动生效，那可以通过自定义路由值提供器来实现，这是更优雅的方案。

第一步：创建自定义RouteValueProvider #

using Microsoft.AspNetCore.Mvc.ModelBinding;
using Microsoft.AspNetCore.Http;

public class PersistentParamRouteValueProvider : RouteValueProvider
{
    private readonly IHttpContextAccessor _httpContextAccessor;
    private const string TargetParamName = "myparam";

    public PersistentParamRouteValueProvider(IHttpContextAccessor httpContextAccessor) 
        : base(RouteValueDictionary.DefaultRouteValueProviderKey)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public override bool ContainsKey(string key)
    {
        return key.Equals(TargetParamName, StringComparison.OrdinalIgnoreCase) 
               && !string.IsNullOrEmpty(GetValue(key));
    }

    public override string GetValue(string key)
    {
        if (!key.Equals(TargetParamName, StringComparison.OrdinalIgnoreCase))
            return null;

        var httpContext = _httpContextAccessor.HttpContext;
        if (httpContext == null) return null;

        // 优先从路由参数取，再从QueryString取
        return httpContext.Request.RouteValues[TargetParamName]?.ToString() 
               ?? httpContext.Request.Query[TargetParamName].FirstOrDefault();
    }
}

第二步：创建对应的ValueProviderFactory #

using Microsoft.AspNetCore.Mvc.ModelBinding;
using Microsoft.Extensions.DependencyInjection;

public class PersistentParamValueProviderFactory : IValueProviderFactory
{
    public Task CreateValueProviderAsync(ValueProviderFactoryContext context)
    {
        var httpContextAccessor = context.ActionContext.HttpContext.RequestServices
            .GetRequiredService<IHttpContextAccessor>();
        
        context.ValueProviders.Add(new PersistentParamRouteValueProvider(httpContextAccessor));
        return Task.CompletedTask;
    }
}

第三步：注册到Mvc服务中 #

在Program.cs（或Startup.cs）里把这个工厂注册到Mvc选项中，注意要插入到最前面，确保优先级最高：

builder.Services.AddControllersWithViews(options =>
{
    // 插入到值提供器列表的最前面，保证优先获取我们的参数
    options.ValueProviderFactories.Insert(0, new PersistentParamValueProviderFactory());
});

// 别忘了注册IHttpContextAccessor，否则上面的类无法获取HttpContext
builder.Services.AddHttpContextAccessor();

这样配置完成后，你原来的Url.RouteUrl("MyRoute")完全不用改，只要当前请求里存在myparam参数，生成的所有URL都会自动带上它。如果某些链接你不想带这个参数，只需要在路由值里显式设置myparam = null即可覆盖全局行为。

注意事项 #

• 如果你的参数不仅出现在QueryString，还可能作为路由参数存在，两种方案里都已经做了兼容处理
• 方案二中，如果需要支持多个持久化参数，只需要修改TargetParamName为参数列表，调整ContainsKey和GetValue的逻辑即可

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