ASP.NET Core MVC URL本地化：动态语言切换路由适配问题

我明白你想要的是无文化前缀的本地化URL（比如/Welcome对应英文、/Bienvenue对应法文），而不是传统的区域化路由格式。你已经完成了基础的路由注册和Cookie文化管理，但遇到了路由选择固定、无法动态适配语言切换的问题，下面是针对性的解决方案：

一、核心问题分析 #

你当前的代码在启动时把所有语言的路由都添加到Action的Selectors中，ASP.NET MVC会按照路由注册顺序匹配（最后注册的会被优先选中？不对，实际是匹配到第一个符合的模板，但你的场景是不同语言模板不同，问题在于无法根据当前请求文化动态筛选路由）。要解决这个问题，我们需要给路由加上文化匹配约束，让MVC只选择与当前用户文化匹配的路由模板。

二、步骤1：添加路由文化约束 #

创建一个自定义的ActionConstraint，用来检查当前请求的文化是否与路由对应的文化匹配：

public class LocalizedRouteConstraint : IActionConstraint
{
    private readonly string _targetCulture;

    public LocalizedRouteConstraint(string targetCulture)
    {
        _targetCulture = targetCulture;
    }

    // 设置优先级，确保这个约束先被执行
    public int Order => 10;

    public bool Accept(ActionConstraintContext context)
    {
        var currentCulture = context.RouteContext.HttpContext.RequestCulture.Culture.Name;
        // 忽略大小写匹配文化名称
        return currentCulture.Equals(_targetCulture, StringComparison.OrdinalIgnoreCase);
    }
}

然后修改你现有的Apply方法，给每个本地化路由添加对应的约束：

public void Apply(ApplicationModel application) {
    foreach (var controller in application.Controllers) {
        foreach (var action in controller.Actions) {
            var localizedRouteAttributes = action.Attributes.OfType<LocalizedRouteAttribute>().ToArray();
            if (localizedRouteAttributes.Any()) {
                foreach (var localizedRouteAttribute in localizedRouteAttributes) {
                    var localizedVersions = GetLocalizedVersionsForARoute(localizedRouteAttribute.Name); 
                    foreach (var localizedVersion in localizedVersions) {
                        if (!action.Selectors.Any(s => s.AttributeRouteModel.Template == localizedVersion.Template)) {
                            var newSelector = new SelectorModel(action.Selectors.First()) {
                                AttributeRouteModel = localizedVersion
                            };
                            // 给路由绑定对应的文化约束
                            newSelector.ActionConstraints.Add(new LocalizedRouteConstraint(localizedVersion.Culture));
                            action.Selectors.Add(newSelector);
                        }
                    }
                }
            }
        }
    }
}

注意：假设你的localizedVersion对象包含Culture属性（比如"en-US"、"fr-FR"），用来标记该路由对应的语言。

这样处理后，当用户请求进来时，MVC只会匹配与当前Cookie中文化一致的路由模板，不会再固定选择最后注册的路由。

三、步骤2：实现动态URL生成（支持语言切换） #

要支持用户切换语言后自动跳转到对应语言的URL，我们需要一个路由映射服务，以及自定义的URL生成方法：

1. 创建本地化路由映射服务 #

这个服务用来存储Action/Controller与不同语言路由模板的对应关系：

public interface ILocalizedRouteProvider
{
    // 根据Action、Controller和文化获取对应的路由模板
    string GetRouteTemplate(string actionName, string controllerName, string culture);
}

public class LocalizedRouteProvider : ILocalizedRouteProvider
{
    private readonly Dictionary<(string Action, string Controller, string Culture), string> _routeMappings;

    public LocalizedRouteProvider()
    {
        // 这里可以从配置文件、数据库加载路由映射，示例硬编码如下
        _routeMappings = new Dictionary<(string, string, string), string>
        {
            { ("Index", "Home", "en-US"), "Welcome" },
            { ("Index", "Home", "fr-FR"), "Bienvenue" },
            // 其他Action的路由映射...
        };
    }

    public string GetRouteTemplate(string actionName, string controllerName, string culture)
    {
        _routeMappings.TryGetValue((actionName, controllerName, culture), out var template);
        //  fallback到默认Action名称
        return template ?? actionName;
    }
}

在Startup中注册这个服务：

services.AddSingleton<ILocalizedRouteProvider, LocalizedRouteProvider>();

2. 自定义URL生成扩展方法 #

扩展UrlHelper，让它能根据当前文化生成对应语言的URL：

public static class UrlHelperExtensions
{
    public static string LocalizedAction(this IUrlHelper urlHelper, string actionName, string controllerName, string culture = null)
    {
        var targetCulture = culture ?? urlHelper.ActionContext.HttpContext.RequestCulture.Culture.Name;
        var routeProvider = urlHelper.ActionContext.HttpContext.RequestServices.GetService<ILocalizedRouteProvider>();
        
        var routeTemplate = routeProvider.GetRouteTemplate(actionName, controllerName, targetCulture);
        
        // 使用本地化路由模板生成URL
        return urlHelper.RouteUrl(new RouteValueDictionary
        {
            { "controller", controllerName },
            { "action", actionName }
        }, routeTemplate);
    }
}

在视图中使用这个方法生成链接：

<a href="@Url.LocalizedAction("Index", "Home")">@Localizer["Home"]</a>

3. 语言切换Controller逻辑 #

处理用户的语言切换请求，更新Cookie并跳转到对应语言的URL：

public IActionResult SwitchLanguage(string culture, string returnUrl)
{
    // 更新文化Cookie
    Response.Cookies.Append(
        CookieRequestCultureProvider.DefaultCookieName,
        CookieRequestCultureProvider.MakeCookieValue(new RequestCulture(culture)),
        new CookieOptions { Expires = DateTimeOffset.UtcNow.AddYears(1) }
    );

    var urlHelper = new UrlHelper(HttpContext);
    var routeProvider = HttpContext.RequestServices.GetService<ILocalizedRouteProvider>();

    // 解析当前返回URL对应的Action和Controller
    var routeData = urlHelper.ActionContext.RouteData;
    var actionName = routeData.Values["action"]?.ToString();
    var controllerName = routeData.Values["controller"]?.ToString();

    // 生成对应文化的本地化URL
    var localizedUrl = urlHelper.LocalizedAction(actionName, controllerName, culture);

    return Redirect(localizedUrl ?? returnUrl);
}

四、额外优化点 #

1. 路由名称唯一性：给每个本地化路由设置唯一名称（localizedVersion.Name = $"{culture}-{controllerName}-{actionName}"），避免路由冲突。
2. 默认文化 fallback：如果用户请求的文化没有对应的路由模板，确保有默认的路由可以匹配。
3. 路由缓存：如果路由映射从数据库或配置加载，可以添加缓存提升性能。

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