Blazor Server项目未使用最新CSS，本地主机仍加载初始文件该如何解决？

我的Blazor Server项目无法加载最新CSS文件，本地始终加载初始版本（截图：）。已尝试过以下操作但无效：

• 按CTRL+F5强制刷新
• 清除浏览器缓存
• 清理并重建项目
• 给CSS链接添加查询字符串参数强制刷新

附上项目的launchSettings.json配置：

{
  "profiles": {
    "https": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "dotnetRunMessages": true,
      "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
      "applicationUrl": "https://localhost:7096;http://localhost:5070"
    },
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
      "nativeDebugging": true
    }
  },
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:27354",
      "sslPort": 44398
    }
  }
}

解决方案 #

1. 禁用开发环境静态文件缓存 #

在Program.cs里配置静态文件中间件时，强制禁用开发环境下的缓存：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        if (app.Environment.IsDevelopment())
        {
            ctx.Context.Response.Headers.Append("Cache-Control", "no-cache, no-store, must-revalidate");
            ctx.Context.Response.Headers.Append("Pragma", "no-cache");
            ctx.Context.Response.Headers.Append("Expires", "0");
        }
    }
});

2. 检查CSS文件的输出配置 #

右键项目中的CSS文件 → 打开属性面板，将复制到输出目录设置为「如果较新则复制」或「始终复制」，确保修改后的文件能同步到输出目录。

3. 彻底清理项目缓存 #

手动删除以下目录的内容，清空项目的编译缓存：

• 项目根目录下的bin和obj文件夹
• 若怀疑NuGet包缓存问题，可删除%USERPROFILE%\.nuget\packages中与当前项目相关的包目录

4. 重置IIS Express（若使用该启动方式） #

• 打开任务管理器，找到并结束所有iisexpress.exe进程
• 删除IIS Express的缓存目录：%USERPROFILE%\Documents\IISExpress

5. 用隐身模式测试 #

直接打开浏览器的隐身窗口访问项目，排除浏览器用户配置的缓存干扰。

6. 启用Blazor热重载 #

在launchSettings.json的对应启动profile中添加热重载配置：

"https": {
  // 原有配置不变
  "hotReloadProfile": "aspnetcore"
}

或者直接用dotnet watch run命令启动项目，自动监测CSS文件变化并刷新页面。

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