软件发出去之后,麻烦才真正开始。第一版装在一百台机器上,第二版改了个配置字段名,升级完成后用户打开程序,窗口大小、主题、最近打开的目录全没了,回到默认值。紧接着有人反馈「更新装不上」,因为旧版程序还在托盘里运行,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 被读取,但不允许被覆盖或删除。更新程序如果和主程序是同一个进程,它没法替换自己;如果旧版还有一个托盘实例没退出,安装程序也会卡在「文件正在使用」。
标准流程是把更新器拆成独立进程,按顺序做:
这里的关键不是「怎么复制文件」,而是「失败时怎么回去」。先把旧目录改名备份,再放新版;新版启动失败,就把新版删掉,把备份改回来。备份目录只保留一份,成功启动并稳定运行后再删。没有这一步,一次失败的更新会让用户彻底打不开软件。
占用问题还有几个边角:杀毒软件可能正在扫描新文件,导致重命名短暂失败;文件被映射为内存映像时,删除操作会延迟到进程退出;某些 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 只能看到一串地址。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,符号和版本一起归档。这四件事做到了,维护期的绝大部分事故都能从「用户说坏了」变成「我们知道哪一行坏了」。
当天可以自己验证的练习:
- 把迁移示例里的
width改成window_width,再跑一次迁移,确认旧键仍然被正确处理。 - 在
save_atomic的写入过程中强制结束进程,检查原文件是否仍然完整。 - 编译崩溃示例,用 Visual Studio 打开生成的 dump,看能不能定位到
main里的空指针写入。 - 把
MiniDumpNormal换成MiniDumpWithFullMemory,对比 dump 体积和可分析的信息量。 - 写一个最小的更新脚本:备份目录、替换文件、启动失败后还原,手动制造一次失败验证回滚。
到这里,C++ 桌面这组八篇就走完了:从选型与代价,到窗口消息、控件布局、资源路径,再到 Qt、模型视图、打包和升级排查。它们不是 API 手册,而是一条从「能弹出窗口」到「敢发给别人用」的路径。下一步可以回到 Win32 补系统集成(托盘、文件关联、服务),或者深入 Qt 的绘制与多线程;无论走哪条,底层那套消息、生命周期和部署逻辑都不会变。