Azure App Service未更新.NET Core 8.0应用：版本变更不生效问题

这类版本更新不生效的问题在Azure Linux App Service部署.NET应用时并不少见，以下是针对问题的分析和可行解决方法：

一、确认发布配置与构建一致性 #

• 检查VS发布配置的构建配置：确保发布时选择的是Release配置，且本地验证版本号时用的也是同配置。部分场景下可能误选了Debug或自定义配置，导致发布的是未更新版本的包。
• 锁定版本属性到对应配置：在项目文件中，将版本属性明确绑定到Release配置，避免被全局配置覆盖，示例：

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
  <VersionPrefix>1.0.1</VersionPrefix>
  <InformationalVersion>1.0.1-beta</InformationalVersion>
</PropertyGroup>

二、强制清理Azure端残留文件 #

即使启用了“删除目标处的额外文件”，Linux环境下可能仍有缓存文件残留：

• 通过Kudu高级工具清理：进入Azure Portal的App Service → 开发工具 → 高级工具 → 启动，打开Bash终端执行：

rm -rf /home/site/wwwroot/*

清空wwwroot目录后重新发布。

• 检查部署槽（如果使用）：若用了部署槽，确认切换槽后旧槽的文件未被意外复用，或者直接清空目标槽的文件。

三、重启应用进程 #

部署后旧进程可能仍占用旧二进制文件，导致新版本无法加载：

• 在Azure Portal手动重启App Service实例；
• 在Kudu的“进程管理器”中找到dotnet进程并终止，系统会自动重启加载新文件。

四、更换部署方式验证 #

若VS发布存在缓存问题，可尝试手动部署：

• 本地生成最新的发布包：执行dotnet publish -c Release -r linux-x64 --self-contained false；
• 使用Azure CLI上传包：执行az webapp deploy --resource-group <你的资源组> --name <你的App Service名> --src-path ./bin/Release/net8.0/linux-x64/publish.zip。

五、排查Azure端缓存问题 #

Azure侧的缓存确实可能导致更新不生效：

• Blazor静态资源缓存：Blazor的静态文件（如css、js）可能被浏览器或服务器缓存，可在发布时启用静态资源哈希（.NET 8默认支持），或修改web.config添加缓存失效规则；
• 平台级缓存：App Service的Linux宿主偶尔会缓存部署文件，重启实例或清空wwwroot可解决；
• CDN缓存：若配置了Azure CDN，需手动清除CDN端点的缓存，或设置缓存过期策略。

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