.NET 8 Blazor Web：迁移_Host.cshtml动态base标签至App.razor的方案

一、动态生成Base标签（替代.NET 7的~语法） #

在.NET 8 Blazor Web项目中，App.razor是Razor组件而非CSHTML页面，无法直接使用~标签助手语法。可以通过注入IHttpContextAccessor动态获取当前请求的路径基，实现和_Host.cshtml一致的适配效果：

1. 注册IHttpContextAccessor服务
   在Program.cs中添加服务注册：

builder.Services.AddHttpContextAccessor();

2. 在App.razor中动态设置Base标签
   修改App.razor的head部分，注入服务并计算路径基：

@inject IHttpContextAccessor HttpContextAccessor

<head>
    @{
        // 获取当前请求的路径基，默认值为"/"
        var pathBase = HttpContextAccessor.HttpContext?.Request.PathBase.ToString() ?? "/";
        // 确保路径始终以"/"结尾，避免路由异常
        if (!pathBase.EndsWith("/"))
        {
            pathBase += "/";
        }
    }
    <base href="@pathBase" />
    <!-- 保留原有meta、样式等head内容 -->
</head>

二、修复大小写路径导致的404错误 #

当访问https://server/App（大写A）出现404时，可通过以下两种方式解决：

方法1：强制Blazor路由使用小写URL #

在Program.cs配置路由时开启小写URL选项：

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode() // 根据你的项目渲染模式调整
    .AddInteractiveWebAssemblyRenderMode()
    .WithRouting(options => options.LowercaseUrls = true);

此配置会自动将路由转换为小写，用户访问大写路径时会匹配到对应的路由。

方法2：IIS URL重写统一路径大小写（部署到IIS时适用） #

在项目的web.config中添加URL重写规则，将所有大写路径重定向为小写：

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="转小写路径" stopProcessing="true">
          <match url=".*[A-Z].*" ignoreCase="false" />
          <action type="Redirect" url="{ToLower:{R:0}}" redirectType="Permanent" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

三、正确使用UsePathBase（解决之前配置无效问题） #

UsePathBase的配置顺序很关键，必须放在静态文件、路由等中间件之前。示例如下：

// 可选：从配置文件读取路径基，方便不同环境切换
var pathBase = builder.Configuration.GetValue<string>("Deployment:PathBase") ?? string.Empty;

if (!string.IsNullOrEmpty(pathBase))
{
    // 确保路径基以"/"开头
    if (!pathBase.StartsWith("/"))
    {
        pathBase = $"/{pathBase}";
    }
    app.UsePathBase(pathBase);
}

// 后续中间件注册必须在UsePathBase之后
app.UseStaticFiles();
app.UseRouting();
// 其他中间件...

通过以上配置，即可实现开发环境（https://localhost:port）和生产环境（https://server/app）的无缝适配，同时解决大小写路径的404问题。

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