WPF应用程序安装及启动时未自动检查更新问题咨询

核心原因梳理 #

• 发布版本号未递增：ClickOnce依赖四位发布版本号判断更新，若本次发布的版本号不高于线上旧版本，客户端会判定无更新
• 服务器部署文件残留：发布生成的全量文件（包含setup.exe、应用名.application、Application Files目录下的新版子文件夹）未完整覆盖服务器旧文件，导致客户端拉取到旧部署清单
• 客户端缓存未清理：ClickOnce默认会在本地缓存部署清单，短时间内重复启动会优先读本地缓存，不会拉取服务器最新清单
• 更新地址配置不匹配：发布设置中填写的「更新位置」URL和实际服务器部署的根地址不一致（大小写、末尾斜杠、路径层级差异都会导致匹配失败），客户端拉取不到新版清单
• 浏览器缓存干扰：用户通过浏览器下载安装包时，浏览器缓存了旧版setup.exe或.application文件，下载到的始终是旧安装包
• 签名证书不匹配：本次发布使用的代码签名证书和旧版本的签名证书不一致，客户端会判定新版本来源不可信，自动跳过更新流程

逐步排查解决方法 #

• 校验版本号：确认本次发布的版本号高于线上旧版本，建议勾选发布设置里的「自动递增修订号」选项，避免人为漏改版本号
• 重新部署服务端文件：先清空服务器上所有旧的ClickOnce部署文件，再将本地发布生成的完整文件全量上传，重点确认根目录下的.application文件更新时间为本次发布时间，Application Files目录下存在对应新版版本号的子文件夹
• 清理客户端缓存：在客户端运行命令 rundll32 dfshim CleanOnlineAppCache 清除ClickOnce本地缓存，再启动应用验证是否触发更新
• 核对更新地址：确认发布设置中填写的更新URL和服务器实际部署的访问根地址完全一致，路径的大小写、末尾斜杠、层级都要完全匹配
• 配置服务端禁止缓存部署文件：在服务器上给.application、.manifest、.exe类型的文件添加响应头 Cache-Control: no-cache, no-store, must-revalidate，避免浏览器或CDN缓存部署文件，用户下载安装包时可以先按Ctrl+F5强制刷新下载页面再下载
• 校验签名证书：确认本次发布使用的代码签名证书和旧版本的证书完全一致，若已更换证书，需要用户先卸载旧版本，再重新安装新版本才能正常后续更新

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