Azure CDN缓存配置问题：如何确保Blazor应用显示最新版本？

针对你遇到的部署后用户需清除浏览器缓存才能看到Blazor新版本的问题，可通过以下分层配置彻底解决：

一、精准配置Azure CDN规则引擎 #

核心思路是区分带哈希的静态资源和根入口文件，分别设置缓存策略：

• 带哈希的静态资源（如_framework/*.dll.js、css/*.css）：这类文件更新后文件名会自动变更（包含32位哈希值），可设置超长缓存时间：
  • 规则条件：路径匹配正则表达式 *.[0-9a-f]{32}.*
  • 缓存行为：选择「覆盖缓存控制」，设置max-age为31536000秒（1年），同时开启「缓存键忽略查询字符串」
• 根入口文件（/ 和 /index.html）：这类文件是Blazor的入口，必须确保每次请求都验证最新版本：
  • 规则条件：路径等于 / 或 /index.html
  • 缓存行为：选择「覆盖缓存控制」，设置max-age为0，开启「必须重新验证」（对应Cache-Control头：no-cache, must-revalidate）
• SignalR端点（/_signalr/*）：实时通信相关资源禁止缓存：
  • 规则条件：路径匹配 /_signalr/*
  • 缓存行为：选择「不缓存」

注意：规则的优先级要设置正确，特定路径规则优先级高于通用规则，避免被全局缓存策略覆盖。

二、优化CDN清除操作 #

执行清除命令时，无需清除所有路径，只针对关键资源即可，同时确保参数完全正确：

az cdn endpoint purge -g <你的资源组名> -n <CDN端点名称> --profile-name <CDN配置文件名称> --content-paths '/' '/index.html' '/_framework/*'

如果执行后仍有延迟，可等待5-10分钟让CDN节点同步，部分区域节点可能需要更长时间。

三、Blazor项目内部配置加固 #

• 确认静态资源哈希命名启用：检查项目文件（.csproj）中是否包含以下配置（默认已开启，若缺失则添加）：

<UseStaticWebAssets>true</UseStaticWebAssets>
<StaticWebAssetBasePath>wwwroot</StaticWebAssetBasePath>

• 确保客户端自动检测新版本：在Program.cs中正确配置中间件，Blazor会自动检测_framework/blazor.boot.json的变化，触发客户端刷新：

app.UseStaticFiles();
app.UseRouting();
app.MapBlazorHub();
app.MapFallbackToPage("/_Host"); // 若为Blazor WebAssembly项目，用MapFallbackToFile("/index.html")

四、浏览器缓存兜底设置 #

在index.html的<head>中添加缓存控制meta标签，避免浏览器强制缓存入口文件：

<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate" />
<meta http-equiv="Pragma" content="no-cache" />
<meta http-equiv="Expires" content="0" />

为什么之前的配置无效？ #

• 若仅配置了通用缓存规则，未区分静态资源和入口文件，会导致index.html被CDN和浏览器长期缓存
• 执行/*的清除命令时，部分CDN节点可能未及时同步，或浏览器本地仍缓存了旧的入口文件
• CDN规则优先级错误，特定路径的缓存策略被全局规则覆盖

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