如何在.NET 9.0 MVC项目中使用WebOptimizer实现Cache Busting（缓存清除）？

我之前在.NET 9 MVC项目里折腾WebOptimizer的缓存清除时也踩过不少坑，文档确实不够详细，给你分享下我亲测有效的配置步骤，应该能解决你的问题：

第一步：在Program.cs里正确配置WebOptimizer服务 #

首先要在服务注册阶段启用缓存清除功能，记得把WebOptimizer的中间件放在静态文件中间件之前，这很关键：

var builder = WebApplication.CreateBuilder(args);

// 注册WebOptimizer并开启缓存清除
builder.Services.AddWebOptimizer(options =>
{
    // 启用缓存清除，默认会在资源URL末尾添加文件内容哈希值
    options.EnableCacheBusting = true;

    // 可选：自定义缓存控制头，比如设置长期缓存
    // options.CacheControlHeader = "public, max-age=31536000";
});

builder.Services.AddControllersWithViews();

var app = builder.Build();

// 必须在UseStaticFiles之前启用WebOptimizer中间件
app.UseWebOptimizer();

app.UseStaticFiles();
// 其他中间件配置（比如路由、授权等）...

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

第二步：在_ViewImports.cshtml中导入TagHelper #

要让视图能识别WebOptimizer的特殊标签，得在_ViewImports.cshtml里添加TagHelper引用：

@addTagHelper *, WebOptimizer.Core

第三步：在视图中引用资源的正确姿势 #

不管是单个资源还是打包后的资源，用WebOptimizer提供的方式引用，它会自动给URL加上哈希值：

方式1：引用打包后的资源 #

如果需要合并压缩多个CSS/JS文件，同时启用缓存清除：

<!-- CSS打包引用 -->
<link rel="stylesheet" href="@WebOptimizer.CssBundle("~/css/bundle.css", "~/css/site.css", "~/css/another-style.css")" />

<!-- JS打包引用 -->
<script src="@WebOptimizer.JsBundle("~/js/bundle.js", "~/js/site.js", "~/js/utils.js")"></script>

方式2：引用单个资源 #

单个文件也能自动生成带哈希的URL：

<link rel="stylesheet" asp-href="~/css/site.css" />
<script asp-src="~/js/site.js"></script>

常见问题排查 #

• 中间件顺序错了：一定要确保UseWebOptimizer()在UseStaticFiles()之前，不然静态文件中间件会直接处理请求，WebOptimizer的缓存清除逻辑不会生效。
• 开发环境未生效：默认开发环境下WebOptimizer可能处于调试模式，不会启用缓存优化。可以手动设置options.DebugMode = false;强制开启（不过开发阶段建议关闭，方便调试）。
• 文件路径错误：如果WebOptimizer找不到指定的资源文件，也不会生成带哈希的URL，检查下文件路径是否和项目里的实际路径一致。

备注：内容来源于stack exchange，提问作者Alex