ASP.NET Core 5 带.html后缀的URL全球化配置报AmbiguousMatchException错误

现有代码的核心问题 #

• 中间件注册顺序错误：调用app.UseRequestLocalization(options)时，会把当前options的配置快照固化到中间件中，你在中间件注册完成后才插入RouteDataRequestCultureProvider，这个配置根本不会生效，URL里的culture参数也无法被识别为当前请求的语言。
• 路由模板结构和目标URL不匹配：你写的路由模板是{culture}/{controller=Home}/{action=Index}.html，属于3段路径结构，需要URL形如/zh-hans/Home/index.html才能匹配，和你要实现的/zh-hans/index.html（2段路径，省略controller层级）的结构完全不符。
• 路由缺少必要的内联约束：culture参数没有限定取值范围，任意路径段都会被当成culture值，导致路由匹配时多个Controller Action被判定为同等匹配优先级，最终触发AmbiguousMatchException。

修复后的可运行代码 #

1. Configure方法调整 #

把语言配置、自定义文化provider的逻辑全部移到UseRequestLocalization之前，重写路由模板匹配目标URL结构，加上culture的正则约束：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
    }

    // 先配置好所有语言相关的参数，再注册中间件
    var supportedCultures = new List<CultureInfo>
    {
        new("en"),
        new("zh-Hans"),
        new("zh-Hant")
    };

    var localizationOptions = new RequestLocalizationOptions
    {
        DefaultRequestCulture = new RequestCulture("en"),
        SupportedCultures = supportedCultures,
        SupportedUICultures = supportedCultures
    };
    // 把路由值提供器插到列表最前面，必须在UseRequestLocalization之前完成
    localizationOptions.RequestCultureProviders.Insert(0, new RouteDataRequestCultureProvider());
    
    app.UseRequestLocalization(localizationOptions);

    app.UseRouting();
    app.UseStaticFiles();

    app.UseEndpoints(endpoints =>
    {
        // 路由模板调整为2段结构，匹配目标URL格式
        // culture加正则约束，只允许匹配支持的语言值，避免路由歧义
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{culture:regex(^(en|zh-Hans|zh-Hant)$)}/{action=Index}.html",
            defaults: new { controller = "Home", action = "Index" }
        );
    });
}

2. 路由匹配逻辑说明 #

调整后的路由可以完全匹配你预期的URL格式：

• 访问/en/index.html → 匹配HomeController.Index，当前语言为en
• 访问/zh-hans/index.html → 匹配HomeController.Index，当前语言为zh-Hans
• 访问/zh-Hans/privacy.html → 匹配HomeController.Privacy，当前语言为zh-Hans
• 访问/zh-Hant/error.html → 匹配HomeController.Error，当前语言为zh-Hant

3. 注意事项 #

• 如果后续需要接入其他Controller（比如OrderController），需要单独为这些Controller补充对应的路由规则，否则现有默认路由只能匹配默认的HomeController。
• 生成页面内的语言切换链接时，需要在路由值里显式传递目标culture参数，避免切换后路由解析错误。

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