ASP.NET Core 5.0部署IIS后静态资源缓存无法刷新及图片更新异常求助

关于wwwroot无需复制到bin的原因 #

ASP.NET Core默认将wwwroot作为静态文件根目录，框架会从应用内容根目录（而非输出bin目录）读取该文件夹内容，所以最初没把wwwroot复制到bin也能正常访问。你添加的.csproj复制配置属于冗余操作，反而可能引发部署时的文件覆盖或残留问题，建议移除：

<!-- 建议删除这段配置 -->
<ItemGroup>
    <Content Update="wwwroot\**\*">
        <CopyToOutputDirectory>PreserveNewset</CopyToOutputDirectory>
    </Content>
</ItemGroup>

部署后wwwroot静态文件缓存问题解决 #

Azure App Service和ASP.NET Core静态文件中间件默认会对静态文件启用缓存策略，导致更新后的文件无法及时生效。可通过修改StaticFileOptions配置自定义缓存规则：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 针对wwwroot静态资源设置合理缓存时间（示例为1小时，可按需调整）
        ctx.Context.Response.Headers.Append("Cache-Control", "public, max-age=3600");
    }
});

如果需要彻底禁用缓存（适合频繁更新的静态文件），可改为：

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");

用户上传头像缓存问题解决 #

动态更新的用户头像属于频繁变更的资源，必须强制禁用缓存，同时可通过URL缓存破坏机制确保浏览器获取最新文件：

1. 服务器端禁用缓存 #

修改自定义静态文件配置的响应头：

app.UseStaticFiles(new StaticFileOptions()
{
    FileProvider = new PhysicalFileProvider("Fully/Qualified/Path"),
    RequestPath = new PathString("Relative/Path"),
    OnPrepareResponse = ctx =>
    {
        // 完全禁用缓存，确保每次请求都获取最新文件
        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. URL缓存破坏机制 #

在生成头像URL时，附加文件的最后修改时间戳作为参数，让浏览器识别为新资源：

// 示例：生成带时间戳的头像URL
var avatarFileName = "avatar.jpg";
var fileProvider = new PhysicalFileProvider("Fully/Qualified/Path");
var fileInfo = fileProvider.GetFileInfo(avatarFileName);
var timestamp = fileInfo.LastWriteTimeUtc.Ticks.ToString();
var avatarUrl = $"/Relative/Path/{avatarFileName}?v={timestamp}";

额外注意事项 #

• 如果Azure App Service启用了CDN，需确保上传目录的资源不被CDN缓存，或在更新后手动刷新CDN缓存。
• 部署时建议使用Azure部署槽位进行蓝绿部署，避免旧版本文件残留导致的缓存问题。
• 测试时可通过浏览器强制刷新（Ctrl+F5）验证效果，但最终需依赖服务器端缓存控制头解决用户端的缓存问题。

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