使用Squirrel.Windows时MyApp自动更新失败问题排查

开发者阿泽

2026-8-21

排查Squirrel.Windows自动更新失败（1.0.0→3.0.0）的解决方案

检查更新源文件完整性
确认发布目录下的RELEASES文件包含3.0.0版本的条目，且条目里的哈希值和MyApp.3.0.0.nupkg、对应full包（如果生成）的实际哈希完全一致。Squirrel依赖这个文件校验版本合法性，哈希不匹配会直接跳过更新。同时要确保发布目录里的3.0.0相关nupkg文件没有损坏。

验证更新代码逻辑
检查应用内的更新代码是否正确实现：

using (var mgr = new UpdateManager("你的发布路径"))
{
    var updateInfo = await mgr.CheckForUpdateAsync();
    if (updateInfo.ReleasesToApply.Any())
    {
        await mgr.UpdateAppAsync();
        // 更新完成必须重启应用才能生效
        Application.Restart();
    }
}

重点确认是否在更新完成后调用了重启逻辑，旧进程不退出的话，新版本文件无法完成替换。

确认版本号格式合规
Squirrel要求版本号严格遵循Major.Minor.Patch格式（如3.0.0），不能带多余的修订号（比如3.0.0.1）。检查Assembly Info里的版本号、NuGet包版本号是否完全一致，格式符合要求。
查看更新日志定位错误
打开%LocalAppData%\MyApp\SquirrelSetup.log或应用自身的日志文件，查找更新过程中的报错信息——比如网络请求失败、目录权限不足、文件被锁定等，这些都是常见的更新失败原因。
排查本地权限与文件锁定
确保当前用户对%LocalAppData%\MyApp目录有完全读写权限，否则Squirrel无法下载或写入新版本文件。另外检查旧版本应用是否被其他进程占用（比如调试器未关闭、后台服务持有进程），导致文件无法被替换。
手动触发更新测试
在应用启动时强制触发更新检查（比如在启动窗口的Loaded事件中直接执行更新代码），观察是否有异常抛出。也可以手动把发布目录的RELEASES和3.0.0的nupkg文件复制到%LocalAppData%\MyApp\packages目录，重启应用后看是否能识别并安装新版本。