ASP.NET MVC Core 3.1项目修改后JS在Xamarin移动端WebView不加载问题

核心原因定位 #

该问题本质是Xamarin Android WebView的缓存机制与静态资源缓存策略不匹配导致，桌面浏览器可正常加载是因为用户主动刷新触发了协商缓存，或桌面端缓存过期时间更短。 #

具体排查方向及解决方法 #

• WebView缓存配置问题 #

Xamarin Android WebView默认启用持久化缓存，若初始化时配置了错误的缓存模式，会优先读取本地缓存忽略服务器更新。
检查WebView初始化代码的缓存模式配置，示例正确配置：

// 生产环境使用默认模式，优先走协商缓存
webView.Settings.CacheMode = CacheMode.LoadDefault;
// 开发测试阶段可临时禁用缓存，强制拉取服务器最新资源
// webView.Settings.CacheMode = CacheMode.LoadNoCache;

若之前配置为LoadCacheElseNetwork，只要本地存在缓存就永远不会请求服务器资源，必须修改为LoadDefault。

• 本地已存在的旧缓存未清理 #

如果测试设备已经加载过旧版JS，旧缓存会持久化存储在本地，修改服务器资源后不会自动更新。
可在加载目标页面前主动清理WebView缓存：

// 第二个参数传true表示清理磁盘缓存，false仅清理内存缓存
webView.ClearCache(true);
webView.ClearHistory();

测试阶段也可直接卸载重装APP，彻底清除本地残留缓存。

• ASP.NET Core静态资源缓存策略配置问题 #

你的ASP.NET Core服务端可能对JS等静态资源设置了过长的Cache-Control max-age有效期，WebView默认不会主动触发强制刷新，只会等缓存过期后才请求新资源。
最优解是使用ASP.NET Core自带的静态资源版本戳功能，彻底规避缓存问题：
在CSHTML页面引用JS文件时添加asp-append-version="true"属性：

<script src="~/js/your-script.js" asp-append-version="true"></script>

该属性会自动基于文件内容生成哈希后缀，只要JS文件内容修改，路径会自动变为/js/your-script.js?v=xxxxxx，不需要手动清理任何缓存，WebView会自动识别为新资源请求最新版本。

• 生产服务器静态资源缓存规则问题 #

检查你生产服务器（IIS/Nginx等）的静态资源响应头，是否对JS文件设置了强制缓存且未配置协商缓存的Etag/Last-Modified响应头，导致WebView无法识别资源已更新。 #

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