.NET 8+ Blazor Web App（服务器端）仅生产环境覆盖基础路径方法

方法1：在Program.cs中通过环境判断配置 #

直接在启动文件里根据运行环境切换基础路径，代码示例：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorComponents()
    .AddServerComponents();

var app = builder.Build();

// 仅生产环境启用自定义基础路径
if (!app.Environment.IsDevelopment())
{
    app.UsePathBase("/你的生产环境基础路径");
}

// 常规中间件配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error", createScopeForErrors: true);
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseAntiforgery();

app.MapRazorComponents<App>()
    .AddServerRenderMode();

app.Run();

把/你的生产环境基础路径替换成实际路径，比如/admin-blazor。

方法2：通过环境配置文件灵活配置 #

这种方式无需修改代码，仅通过配置文件调整路径：

1. 在项目根目录新建appsettings.Production.json，写入配置内容：

{
  "PathBase": "/你的生产环境基础路径"
}

2. 在Program.cs中读取配置并应用：

var builder = WebApplication.CreateBuilder(args);

// 从配置文件读取基础路径
var pathBase = builder.Configuration["PathBase"];

builder.Services.AddRazorComponents()
    .AddServerComponents();

var app = builder.Build();

// 非开发环境且配置了有效路径时生效
if (!app.Environment.IsDevelopment() && !string.IsNullOrEmpty(pathBase))
{
    app.UsePathBase(pathBase);
}

// 后续中间件配置
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseAntiforgery();

app.MapRazorComponents<App>()
    .AddServerRenderMode();

app.Run();

后续调整路径只需修改appsettings.Production.json，无需重新编译项目。

额外提醒 #

• 设置基础路径后，Blazor的路由、静态资源引用会自动适配该路径，无需修改组件内的链接
• 若使用IIS部署，需将站点虚拟路径与配置的基础路径保持一致，避免访问冲突

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