.NET Core 6发布时自动递增appsettings.json值解决静态资源缓存问题

一、自动递增appsettings.json版本号的实现方法 #

如果坚持要通过递增配置文件中的版本号来实现需求，可以按以下步骤操作：

1. 在配置文件中添加版本项
   在appsettings.json中新增一个用于标记静态资源版本的配置：

   {
     "StaticAssetVersion": 1
   }
   

2. 发布时自动递增版本号
   在项目的.csproj文件中添加MSBuild目标，在发布前执行PowerShell脚本递增版本号：

   <Target Name="IncrementStaticAssetVersion" BeforeTargets="Publish">
     <PropertyGroup>
       <AppSettingsPath>$(ProjectDir)appsettings.json</AppSettingsPath>
     </PropertyGroup>
     <Exec Command="powershell -Command &quot;$json = Get-Content '$(AppSettingsPath)' | ConvertFrom-Json; $json.StaticAssetVersion += 1; $json | ConvertTo-Json -Depth 10 | Set-Content '$(AppSettingsPath)'&quot;" />
   </Target>
   

   这个目标会在每次执行发布命令前，读取appsettings.json并将StaticAssetVersion的值加1，再写回文件。

3. 在视图中引用版本号
   在Razor视图里读取配置项，将版本号作为查询参数附加到静态资源URL后：

   <link rel="stylesheet" href="~/css/site.css?v=@Configuration["StaticAssetVersion"]" />
   <script src="~/js/site.js?v=@Configuration["StaticAssetVersion"]"></script>
   

二、更推荐的静态资源缓存解决方案 #

手动维护版本号存在局限性（比如个别文件修改却全量更新版本），以下是更高效可靠的方案：

1. 利用文件内容哈希自动生成版本号 #

.NET Core自带的TagHelper支持自动计算静态文件的内容哈希，并附加到URL中，无需手动维护版本号：

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

原理：中间件会根据文件内容生成唯一哈希值，当文件内容修改时，哈希值自动变化，浏览器会识别到新的URL并请求最新资源。

2. 配合长期缓存策略 #

在Program.cs中配置静态资源的缓存头，设置长期缓存有效期，结合哈希版本号实现最优缓存效果：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 设置静态资源缓存有效期为1年
        ctx.Context.Response.Headers.Append(
            "Cache-Control", "public, max-age=31536000");
    }
});

这样，当文件未修改时，浏览器会长期缓存资源；文件修改后，URL带新哈希，浏览器自动拉取新版本，既减少服务器请求又保证资源更新。

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