ASP.NET Core CMS多语言SEO路由搭建及静态资源拦截问题求解

你的实现思路完全合理，是多语言CMS系统处理SEO友好路由的标准实现方向，以下是高性能的落地方案：

1. 优先解决静态资源被拦截问题 #

调整中间件注册顺序，将静态文件中间件放在路由中间件之前，所有静态资源请求会被直接处理，不会进入后续路由匹配逻辑：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 静态文件中间件必须放在最前面，优先处理js、css、favicon等资源
app.UseStaticFiles();

app.UseRouting();
app.UseAuthorization();

// 其他路由规则配置在此处

2. 路由规则配置 #

推荐两种高性能实现方案，可根据项目需求选择：

方案A：带约束的常规路由（性能最优） #

给语言参数加正则约束，避免将普通页面路径误识别为语言代码，按优先级先后配置带语言和不带语言的路由规则：

// 匹配带语言代码的路径，比如 /en-US/about
app.MapControllerRoute(
    name: "localizedPage",
    pattern: "{culture:regex(^[a-z]{{2}}-[A-Z]{{2}}$)}/{slug?}",
    defaults: new { controller = "Page", action = "Render" });

// 匹配不带语言代码的路径，比如 /about 或者根路径
app.MapControllerRoute(
    name: "defaultPage",
    pattern: "{slug?}",
    defaults: new { controller = "Page", action = "Render", culture = "" });

该方案的路由匹配逻辑由ASP.NET Core路由系统原生实现，无额外性能开销。

方案B：回退路由（灵活性最高） #

如果你的项目还有其他路由规则（比如后台管理路由、API路由），可以在所有路由最后配置回退路由，只有当其他路由都不匹配时才会进入页面渲染逻辑，完全不会冲突：

// 先配置其他业务路由，比如后台路由
app.MapControllerRoute(
    name: "admin",
    pattern: "Admin/{controller=Home}/{action=Index}/{id?}");

// 最后配置页面回退路由
app.MapFallbackToController("Render", "Page");

3. Action逻辑实现 #

在对应的Controller中统一处理参数解析和数据查询，提前给数据库pages表的seo-url和language字段加联合索引，可将查询耗时压缩到毫秒级：

public class PageController : Controller
{
    private readonly ISiteConfigService _siteConfigService;
    private readonly IPageService _pageService;

    public PageController(ISiteConfigService siteConfigService, IPageService pageService)
    {
        _siteConfigService = siteConfigService;
        _pageService = pageService;
    }

    public async Task<IActionResult> Render(string culture, string slug)
    {
        // 处理文化参数
        if (string.IsNullOrWhiteSpace(culture))
        {
            // 优先读取数据库配置的站点默认语言
            culture = await _siteConfigService.GetDefaultCultureAsync();
            if (string.IsNullOrWhiteSpace(culture))
            {
                // 无配置时读取浏览器默认语言
                culture = Request.GetTypedHeaders().AcceptLanguage?.FirstOrDefault()?.Value.Value ?? "en-US";
            }
        }

        // 处理SEO路径，根路径默认对应首页
        slug ??= "/";
        if (!slug.StartsWith('/'))
        {
            slug = $"/{slug}";
        }

        // 查询对应页面内容
        var page = await _pageService.GetBySeoUrlAndCultureAsync(slug, culture);
        if (page == null)
        {
            return NotFound();
        }

        return View(page);
    }
}

额外性能优化 #

可以加内存缓存层，将{culture}:{slug}作为缓存键，缓存查询到的页面数据，设置合理的过期时间，页面内容更新时主动清除对应缓存，可进一步降低数据库压力。

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