.NET 6 Web应用自定义环境下site.css缺失 静态资源配置问询

正确实现代码 #

首先确保launchSettings.json中配置了自定义环境变量：

"profiles": {
  "http": {
    "commandName": "Project",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "LocalDevelopment"
    }
  }
}

Program.cs 编写规则：

var builder = WebApplication.CreateBuilder(args);

// 仅在自定义本地开发环境下启用静态Web资产，必须放在所有服务配置之前
if (builder.Environment.IsEnvironment("LocalDevelopment"))
{
    builder.Host.ConfigureWebHostDefaults(webBuilder =>
    {
        webBuilder.UseStaticWebAssets();
    });
}

// 后续服务配置保持不变，示例如下
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

var app = builder.Build();

// 中间件配置保持默认顺序即可，无需修改UseStaticFiles相关逻辑
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

之前写法失效原因 #

• 写法一builder.WebHost.UseStaticWebAssets()报错：.NET 6+ 中WebApplicationBuilder.WebHost的配置逻辑被限制，调用UseStaticWebAssets会尝试修改已初始化完成的WebRoot路径，触发不支持修改的异常。
• 写法二builder.Host.ConfigureWebHost(c => c.UseStaticWebAssets())无效果：ConfigureWebHost的调用顺序错误，必须放在所有服务配置之前，才能在主机初始化阶段加载静态资产映射规则。
• 写法三只指定WebRootPath无效果：自定义环境下默认不加载静态Web资产的映射配置，仅指定Web根路径无法解析开发阶段散落在项目各个目录下的静态资源（比如Razor类库中的静态资源、Blazor组件的隔离样式等）。

注意事项 #

• UseStaticWebAssets仅用于开发阶段调试，生产环境无需配置，发布时所有静态资源会被自动打包到wwwroot目录。
• 代码中判断的环境名必须和launchSettings.json中配置的ASPNETCORE_ENVIRONMENT值完全一致，区分大小写。

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