软件发出去之后,麻烦才真正开始。第一版装在一百台机器上,第二版改了个配置字段名,升级完成后用户打开程序,窗口大小、主题、最近打开的目录全没了,回到默认值。紧接着有人反馈「更新装不上」,因为旧版程序还在托盘里运行,exe 被占用,安装程序覆盖不了。再后来某个用户一点「导出」就闪退,日志里只有一行「程序已停止工作」,什么线索都没有。

这三类问题——数据不兼容、文件换不掉、崩溃抓不到——是桌面软件维护期的主要成本。它们不在功能需求里,却决定了用户会不会继续用。这篇把三件事分别讲清楚,并给出可编译的配置迁移和崩溃转储示例。

升级的第一步是管住数据

配置丢失通常不是「安装包删了文件」,而是程序自己不认识旧数据。旧版写的是 width=1024,新版读的是 window_w,读不到就套默认值,然后把文件整个重写,旧的键被抹掉。用户看到的就是「升级后设置全没了」。

正确做法是给配置加版本号,读取时按版本逐级迁移:旧键改名、缺的键补默认值、废弃的键删除,最后写回新版本。迁移必须是幂等的——同一份配置跑两次迁移,结果要一样,不能第二次把已经改好的键又改坏。

写入还要保证原子性。直接覆盖原文件时,如果程序在写到一半时崩溃或断电,文件会变成半截,下次启动解析失败,配置彻底损坏。稳妥做法是写临时文件,写完关闭,再重命名覆盖原文件。同一目录下的重命名在 Windows 上是原子操作,要么是旧文件,要么是新文件。

下面这段程序先造一份 v1 配置,迁移到 v2,再用「临时文件加重命名」的方式写回。完整可编译:

std::map<std::string, std::string> migrate(std::map<std::string, std::string> values) {
    if (values.count("width") && !values.count("window_w")) {
        values["window_w"] = values["width"];
        values.erase("width");
    }
    if (!values.count("font_size")) values["font_size"] = "14";
    if (!values.count("version")) values["version"] = "2";
    return values;
}

bool save_atomic(const std::filesystem::path& path,
                 const std::map<std::string, std::string>& values) {
    auto tmp = path;
    tmp += ".tmp";
    std::ofstream out(tmp, std::ios::binary | std::ios::trunc);
    if (!out) return false;
    for (const auto& [k, v] : values) {
        out << k << '=' << v << '\n';
    }
    out.close();
    if (!out.good()) return false;
    std::filesystem::rename(tmp, path);
    return true;
}

完整的读取函数把每行按第一个等号切开,去掉首尾空白。运行后本机实际输出:

v1 keys: theme=dark width=1024 
migrate: ok
v2 keys: font_size=14 theme=dark version=2 window_w=1024 
tmp exists: no

输出验证了三件事:旧键 width 被改名成 window_w;缺失的 font_size 补上了默认值;临时文件在重命名后不存在了,说明替换成功。

ofstream::close() 只保证进程内的缓冲交给系统,不保证数据已经落到磁盘。要抗断电,还得在关闭前调用 FlushFileBuffers(Windows 文件句柄 API),或者用支持刷盘的写入方式。普通工具做到「要么旧文件、要么新文件」通常够用,关键数据再加一层。

还有一个细节是重命名的目标必须同目录。跨目录或跨卷的 rename 在 Windows 上不是原子替换,会退化成复制加删除,中途失败就留下半截文件。所以临时文件要写成「原文件名 + .tmp」放在同一个目录,而不是丢到 %TEMP% 再搬回来。

目录本身也要先确认存在。第一次运行时用户目录下可能没有子目录,create_directories 失败而没人检查,后面的写入会静默失败。写入路径、创建目录、重命名这三步的返回值都要看,缺一个就会出现「配置保存成功,重启又变默认」的怪事。

为什么 exe 换不掉

Windows 允许运行中的 exe 被读取,但不允许被覆盖或删除。更新程序如果和主程序是同一个进程,它没法替换自己;如果旧版还有一个托盘实例没退出,安装程序也会卡在「文件正在使用」。

标准流程是把更新器拆成独立进程,按顺序做:

一次可以回滚的替换流程
下载新包放到临时目录,不直接覆盖安装目录
校验核对哈希或签名,确认包完整
请求退出通知主程序保存并退出,等待进程结束
备份旧版把当前目录改名成 .bak
换入新版解压或移动到原目录
启动验证新进程能起来就清理备份,起不来就还原

这里的关键不是「怎么复制文件」,而是「失败时怎么回去」。先把旧目录改名备份,再放新版;新版启动失败,就把新版删掉,把备份改回来。备份目录只保留一份,成功启动并稳定运行后再删。没有这一步,一次失败的更新会让用户彻底打不开软件。

占用问题还有几个边角:杀毒软件可能正在扫描新文件,导致重命名短暂失败;文件被映射为内存映像时,删除操作会延迟到进程退出;某些 shell 扩展或预览处理器会加载你的 DLL。遇到「明明退出了还被占用」,用 Process Explorer 的「Find Handle」查是哪个进程持有句柄,不要靠猜。

安装包方案(上一篇文章提过的 Inno Setup、WiX)通常自带「关闭运行中的程序」逻辑,但不要完全依赖它。自己实现的更新器至少要检测主进程是否退出,并给用户一个明确的提示,而不是静默失败。

崩溃了,先留下现场

用户说「闪退」,你能拿到的信息通常只有一句「程序已停止工作」。要排查,必须让程序在崩溃瞬间留下现场:日志、dump、版本号、构建标识。日志告诉你崩溃前在做什么,dump 告诉你崩溃时线程停在哪。

Windows 的崩溃转储用 MiniDumpWriteDump 生成,依赖 dbghelp.dll。下面是一个最小实现,只对致命异常写 dump,并防止处理器自身递归:

bool IsFatal(DWORD code) {
    return code == EXCEPTION_ACCESS_VIOLATION
        || code == EXCEPTION_STACK_OVERFLOW
        || code == EXCEPTION_ILLEGAL_INSTRUCTION
        || code == EXCEPTION_INT_DIVIDE_BY_ZERO;
}

LONG WINAPI OnFatal(EXCEPTION_POINTERS* info) {
    static bool writing = false;
    if (writing) return EXCEPTION_CONTINUE_SEARCH;
    if (!IsFatal(info->ExceptionRecord->ExceptionCode))
        return EXCEPTION_CONTINUE_SEARCH;

    writing = true;
    MINIDUMP_EXCEPTION_INFORMATION mei{};
    mei.ThreadId = GetCurrentThreadId();
    mei.ExceptionPointers = info;
    mei.ClientPointers = FALSE;

    HANDLE file = CreateFileW(L"crash.dmp", GENERIC_WRITE, 0, nullptr,
                              CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, nullptr);
    if (file != INVALID_HANDLE_VALUE) {
        MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), file,
                          MiniDumpNormal, &mei, nullptr, nullptr);
        CloseHandle(file);
    }
    return EXCEPTION_CONTINUE_SEARCH;
}

int main() {
    SetErrorMode(SEM_NOGPFAULTERRORBOX);
    AddVectoredExceptionHandler(1, OnFatal);
    volatile int* p = nullptr;
    *p = 42;
    return 0;
}

编译要加 -ldbghelp:

g++ -std=c++20 crash.cpp -o crash.exe -ldbghelp
.\crash.exe

本机实测的结果要分开说:进程确实以访问冲突结束,退出码 -1073741819,也就是 0xC0000005;但工作目录里没有出现 crash.dmp,也没有 dump-log.txt。异常发生了,现场没留下。这条实验只证明了「程序会崩」,没有证明「dump 会落盘」,两件事不能混成一句「崩溃转储已验证」。

没落盘不等于代码一定写错,可能是处理器没被执行、MiniDumpWriteDump 返回失败、目标路径不可写,或者被系统的错误报告机制接走了。现在这个示例把 MiniDumpWriteDump 的返回值直接丢掉,也没有打印 GetLastError,所以连失败原因都没有记录——这本身就是示例的毛病。

为什么用向量异常处理器而不是更常见的 SetUnhandledExceptionFilter?两者都能做,但触发时机和拦到的异常范围不同:向量处理器在异常分发的早期被调用,能看到第一次异常;未处理异常过滤器要等没人处理时才轮到它。本机这次用的是向量处理器,但「处理器有没有真的执行」同样没有日志证据,不能因为进程退出了就认定它跑过。

要把这件事查清,顺序是固定的。第一步,把 MiniDumpWriteDump 的返回值存下来,非 S_OK 就把 GetLastError 一起写进文本日志;第二步,把 dump 路径改成绝对路径,指向一个确定可写的目录,先用 CreateFileW 试写一个小文件确认权限;第三步,如果还是空,去注册表 HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps 配系统级转储,或用 ProcDump 挂在进程上抓一次,判断是「程序没写」还是「写了但被别的东西接走」。这三步里任何一步没做完,就不该在文档里写「dump 已验证」。

dump 可能包含用户数据:窗口标题、文件路径、内存里的字符串。收集前要告知用户,传输和存储要加密,保留期限要明确。把 dump 当成普通日志随便上传,是隐私事故。

dump 拿到之后怎么看

没有符号,dump 只能看到一串地址。MiniDumpWriteDump 记录的是模块名加偏移,要还原成函数名和行号,需要与构建版本严格匹配的 PDB 文件。所以发布流程里必须做一件事:每次构建都把 exe、PDB、版本号、构建时间一起归档。

用 Visual Studio 打开 dump,或者用 WinDbg 的 !analyze -v,通常能直接看到异常类型、出错线程、调用栈。如果栈里全是「未知模块」,先检查 PDB 搜索路径和版本是否匹配;版本不匹配的 PDB 比没有更糟,它会给出错误的函数名。

拿到调用栈之后,排查顺序是:先看异常类型(空指针、越界、栈溢出、除零),再看出错线程是不是 UI 线程,最后结合日志还原用户操作。很多崩溃不是代码写错,而是「对象已经销毁,回调还在跑」——比如窗口关了,定时器消息还在队列里;模型释放了,后台线程还在发信号。这类问题在开发机上很难复现,dump 是唯一的现场。

日志和 dump 要配套。日志至少记录:启动时的版本和构建号、关键操作的开始与结束、异常捕获点、退出原因。日志用追加写、按大小轮转,别在崩溃路径上做复杂格式化,否则日志本身可能再次崩溃。

更新通道与回滚策略

自动更新的完整链路是:检查版本、下载、校验、安装、验证、失败回滚。每一环都要有明确的失败处理。

检查版本时,服务端返回的不只是「最新版本号」,还应该包含下载地址、文件大小、哈希、最低兼容版本、是否强制更新。客户端要能处理「网络不通」「返回格式错误」「版本号回退」这些情况,不能把异常吞掉当成「已是最新」。

下载和校验必须绑定。只比对版本号不校验文件,下载被劫持或中断都会把坏包装进去。校验失败要删除临时文件并重试,不要继续安装。HTTPS 能防传输篡改,但防不了服务端被入侵,所以签名校验仍然必要。

安装时机要尊重用户。正在编辑文档时强制重启,是很多人讨厌自动更新的原因。更好的做法是提示「新版本已就绪,下次启动时生效」,把替换放到退出后。强制更新只用于安全修复,并且要给出明确说明。

回滚不是「再发一个旧版本安装包」。它要求在本地保留可回退的副本,并且数据迁移要能双向兼容。如果新版把配置改成了新格式,回滚后的旧版读不懂,用户还是会丢设置。所以迁移设计要留后路:新字段可以新增,旧字段先别删;真要删,等两个版本之后。

本机没有更新服务器,也没有代码签名证书,所以整条自动更新链路没有跑过:检查版本、下载、校验、替换、启动验证、失败回滚,目前都只是流程设计,不是实测结论。能真正跑通的只有前半段——配置的版本号迁移,以及「临时文件加重命名」的写入。输出里能看到 width 改名为 window_w、font_size 补上默认值、临时文件在重命名后消失。替换 exe 和回滚这两步,卡在没有可用的更新端点和没有第二台干净机器。

也正因为没跑过,「更新器一定要能回滚」只能当设计原则,不能当已验证的能力。真要上线,至少要在虚拟机上手动演一遍:装旧版、造一份旧配置、故意让新版启动失败、确认备份目录能改回来、确认旧版读得懂迁移后的文件。安装包那一层同理,本机没有做 Inno Setup 之类的封装,所以安装包体积、升级覆盖行为、卸载残留都没有数据,只能等真实打包时再补。

出问题时先看哪里

现象真实原因第一步查什么
升级后配置全丢字段改名没有迁移,读取失败后套默认值并覆盖原文件对比升级前后的配置文件,确认迁移函数是否覆盖了所有旧键
升级后程序打不开新版缺文件、依赖不匹配,或安装包覆盖不完整看安装日志与目录内容,确认版本号和文件清单一致
提示 exe 正在使用,无法替换旧进程未退出,或更新器与主程序同进程用 Process Explorer 查句柄持有者,确认托盘实例是否还在
更新后配置变成半截乱码直接覆盖写入,写到一半中断检查是否使用临时文件加重命名,是否有写失败处理
崩溃后没有任何 dump没有注册异常处理器,或写入目录无权限确认处理器注册时机,以及 dump 路径是否可写
dump 能打开但栈全是地址缺少对应版本的 PDB,或符号路径不对核对 exe 构建号与 PDB,配置正确的符号搜索路径
回滚后问题依旧新版本已经改写了用户数据,旧版无法还原检查迁移是否可逆,回滚前是否备份了配置
更新检查总是「已是最新」网络错误或解析失败被吞掉,按默认分支处理在检查逻辑里记录请求结果和解析结果,区分「无更新」与「检查失败」

边界与代价

自动更新是一套基础设施,不是加个按钮。你需要版本服务、文件托管、签名密钥、灰度发布、回滚预案、崩溃收集,任何一环缺失都会在用户那里放大。团队小于三个人、用户量不大的内部工具,手动发安装包加一个「检查更新」链接,往往比自建整套系统更划算。

崩溃收集也有成本。dump 上传需要带宽和存储,符号管理需要流程,隐私合规需要告知与授权。更现实的做法是分级:内部工具只留日志和本地 dump,用户手动提供;对外产品才做自动上报,并且默认关闭,让用户选择。

回滚说起来简单,做起来受数据约束。只要新版本写过一次新格式,旧版本就可能读不懂。真正的回滚能力来自「向前兼容的迁移设计」,而不是「保留一个旧安装包」。这一点在需求评审时就该定下来,不能等出事再补。

最后,别把更新当成「修复一切的手段」。频繁更新会消耗用户信任,也会让测试矩阵膨胀。发版节奏稳定、变更说明清楚、失败能回退,比「一天三个热修复」更专业。

小结

升级前先给数据加版本号和迁移;写配置用临时文件加重命名;替换 exe 用独立更新器,先备份再替换,失败能还原;崩溃现场靠日志加 dump,符号和版本一起归档。这四件事做到了,维护期的绝大部分事故都能从「用户说坏了」变成「我们知道哪一行坏了」。

当天可以自己验证的练习:

  1. 把迁移示例里的 width 改成 window_width,再跑一次迁移,确认旧键仍然被正确处理。
  2. 在 save_atomic 的写入过程中强制结束进程,检查原文件是否仍然完整。
  3. 编译崩溃示例,用 Visual Studio 打开生成的 dump,看能不能定位到 main 里的空指针写入。
  4. 把 MiniDumpNormal 换成 MiniDumpWithFullMemory,对比 dump 体积和可分析的信息量。
  5. 写一个最小的更新脚本:备份目录、替换文件、启动失败后还原,手动制造一次失败验证回滚。

到这里,C++ 桌面这组八篇就走完了:从选型与代价,到窗口消息、控件布局、资源路径,再到 Qt、模型视图、打包和升级排查。它们不是 API 手册,而是一条从「能弹出窗口」到「敢发给别人用」的路径。下一步可以回到 Win32 补系统集成(托盘、文件关联、服务),或者深入 Qt 的绘制与多线程;无论走哪条,底层那套消息、生命周期和部署逻辑都不会变。