.NET Core 2.1 Razor Pages主题化页面加载异常排查

你遇到的核心问题是：主题视图扩展器仅对Shared目录下的布局生效，但页面本身仍加载默认的/Pages/{PageName}.cshtml，而非主题文件夹下的对应页面。这是因为你的ThemeViewLocationExpander没有正确覆盖Razor Pages的页面视图查找路径，仅处理了Shared视图的规则。

下面是具体的修复步骤和代码调整方案：

1. 修正ThemeViewLocationExpander的视图路径扩展逻辑 #

需要确保页面视图的查找优先级为主题文件夹 > 默认顶级文件夹，同时保留Shared视图的主题优先规则。修改后的扩展器代码如下：

public class ThemeViewLocationExpander : IViewLocationExpander
{
    public void PopulateValues(ViewLocationExpanderContext context)
    {
        // 从RouteData获取主题值（域名判断逻辑可放在此处或中间件中）
        var theme = context.ActionContext.RouteData.Values["theme"]?.ToString() ?? "Default";
        context.Values["theme"] = theme;
    }

    public IEnumerable<string> ExpandViewLocations(ViewLocationExpanderContext context, IEnumerable<string> viewLocations)
    {
        if (!context.Values.TryGetValue("theme", out var themeValue))
        {
            themeValue = "Default";
        }
        var theme = themeValue.ToString();

        // 生成主题文件夹下的页面视图路径，优先级高于默认路径
        var themedPageLocations = viewLocations
            .Select(loc => loc.Replace("/Pages/", $"/Pages/Themes/{theme}/"))
            .ToList();

        // 保留默认页面路径作为后备方案
        themedPageLocations.AddRange(viewLocations);

        // 单独处理Shared视图（主题下的Shared优先，再加载顶级Shared）
        var themedSharedLocations = new List<string>
        {
            $"/Pages/Themes/{theme}/Shared/{{0}}.cshtml",
            "/Pages/Shared/{0}.cshtml"
        };

        // 合并路径：页面路径在前，Shared路径在后
        return themedPageLocations.Concat(themedSharedLocations);
    }
}

关键调整说明： #

• 新增了主题页面路径的生成逻辑，确保主题文件夹内的页面优先被查找；
• 保留默认路径作为 fallback，满足「主题文件夹有重写则用，无则用默认页面」的需求；
• 单独维护Shared视图的查找规则，保证布局等共享资源的主题化生效。

2. 确保主题值正确注入到RouteData #

在Startup.cs的Configure方法中添加中间件，根据访问域名映射主题值并注入到RouteData：

app.Use(async (context, next) =>
{
    // 根据域名设置主题（替换为你的实际域名判断逻辑）
    var requestedTheme = "Default";
    if (context.Request.Host.Host.Equals("fresh.yourdomain.com", StringComparison.OrdinalIgnoreCase))
    {
        requestedTheme = "Fresh";
    }
    else if (context.Request.Host.Host.Equals("dark.yourdomain.com", StringComparison.OrdinalIgnoreCase))
    {
        requestedTheme = "Dark";
    }

    // 将主题值注入RouteData，供视图扩展器使用
    context.Request.RouteValues["theme"] = requestedTheme;
    await next();
});

3. 确认扩展器注册配置 #

在Startup.cs的ConfigureServices中确保正确注册视图扩展器：

services.AddMvc()
    .AddRazorPagesOptions(options =>
    {
        options.ViewLocationExpanders.Add(new ThemeViewLocationExpander());
    });

测试效果 #

调整完成后：

• 若/Pages/Themes/Default/Index.cshtml存在，会优先加载该主题页面；
• 删除主题下的Index.cshtml后，会自动 fallback 到/Pages/Index.cshtml；
• 布局文件仍会优先加载主题文件夹下的/Pages/Themes/{Theme}/Shared/_Layout.cshtml，符合预期。

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