ClickOnce部署C# Windows应用版本停留在1.0.0.0不更新问题求助

常见触发根源 #

• 部署清单版本号配置错误
  部分发布流程会遗漏同步应用清单、部署清单的版本号，或者Publish Version配置项没有开启自动递增，服务器端部署清单的版本始终低于或等于客户端已安装版本，ClickOnce的默认更新逻辑会判定无可用更新。
  排查点：检查服务器端.application部署文件内的asmv1:assembly节点的version属性，确认是否高于客户端当前安装的1.0.0.0版本。
• 客户端本地ClickOnce缓存损坏
  客户端的ClickOnce本地存储目录%LocalAppData%\Apps\2.0下的缓存文件出现损坏、版本记录冲突时，会导致更新校验逻辑直接跳过，始终加载最早安装的1.0.0.0版本。这种情况对应重装可临时解决的场景：重装会清空对应应用的缓存条目。
• 更新触发时机配置问题
  如果更新逻辑配置为应用启动后后台检查更新，且未做强制更新提示，部分用户会始终不重启应用，导致更新一直未被应用；另外如果配置了minimumRequiredVersion属性，且该属性值低于最新版本，ClickOnce不会强制用户安装更新，部分用户点击跳过更新后就会一直运行旧版本。
• 服务器端部署文件签名不匹配
  后续发布版本使用的签名证书和首次发布1.0.0.0版本使用的证书不一致，又没有配置证书信任迁移规则的情况下，ClickOnce会判定新版本为未授权应用，拒绝执行更新，继续运行旧版本。
• 客户端权限不足
  部分受限用户账户没有%LocalAppData%\Apps\2.0目录的写入权限，更新文件下载后无法写入缓存，更新流程静默失败，继续运行原有版本。

对应的永久修复方案 #

• 规范发布流程校验
  每次发布后自动校验服务器端.application文件的版本号是否和当前发布版本一致，开启Visual Studio发布配置里的自动递增Publish Version选项，确保每次发布版本号都高于上一版。
• 内置缓存损坏自动修复逻辑
  在应用启动时先执行更新校验，如果连续3次检测到服务器端有更高版本但本地始终无法触发更新，自动调用dfsvc.exe工具的清理命令执行应用级缓存清理：
  rundll32 dfshim CleanOnlineAppCache
  清理完成后自动重启应用触发更新，不需要用户手动重装。
• 调整更新校验逻辑
  把更新触发时机调整为应用启动前先检查更新，如果有强制更新需求，在部署清单里配置minimumRequiredVersion为最新版本号，强制用户必须完成更新才能启动应用，避免用户跳过更新。
• 处理签名证书兼容问题
  如果需要更换签名证书，提前在新版本的部署清单里添加旧证书的信任哈希，或者在应用内提前部署新证书的信任规则，避免签名不匹配导致的更新拦截。
• 权限校验逻辑补充
  应用启动时检测本地ClickOnce缓存目录的写入权限，如果权限不足提前弹出提示引导用户使用有权限的账户运行，或者联系管理员开通目录权限。
• 临时应急手动修复方案
  遇到用户反馈该问题时，不需要重装应用，让用户执行以下操作即可：
  1. 关闭当前运行的应用
  2. 按下Win+R打开运行窗口，输入%LocalAppData%\Apps\2.0回车打开缓存目录
  3. 搜索目录下和你的应用名称匹配的文件夹全部删除
  4. 重新启动应用即可自动拉取最新版本

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