Skip to content

新版本号比旧号小,装了新版的机器被换回了旧版 ​

一句话结论:把版本号从 5.6.x 重置成 1.0.0 之后,更新清单里留着的旧后端号反而「更大」,装着新版的机器被自动换回了旧版。

起因 ​

决定跳过中间的 5.6.72,直接发 1.0.0,第一次带上代码签名。理由很直接:还没有真实用户,换轨的代价此刻最低。

覆盖安装实测都过了:用户数据 109 个文件、193,461,014 字节一字未动,卸载项仍只有一条,健康检查返回 1.0.0,壳和后端版本一致、不拒绝启动。看起来是一次干净的首发。

排查过程 ​

反向降级 ​

问题出在下一次启动。健康检查回落到 5.6.67,原来的可执行文件被改名留了底,新版本没写回。

查下来是清单里的残留字段:更新清单还带着一个后端版本号 5.6.67,而更新器的比较逻辑是纯数字元组比较——(5,6,67) 逐位大于 (1,0,0)。于是它认定「远端有更新的后端」,把已经装好的 1.0.0 换成了旧的 5.6.67。版本号断代这件事,比较器并不知情。

处置没去改比较逻辑,而是把清单里的后端号整个撤掉。壳侧解析结构里这个字段没有默认值,缺键会直接反序列化失败,走进安全降级分支「沿用现有可执行文件」。实测重启后健康检查稳定在 1.0.0、可执行文件大小和留底文件时间都没变、更新记录为空,反向降级消失。

这里有个取舍值得记:改比较逻辑要动已装机客户端,撤一个字段只动服务端清单。选后者。

同批踩到的四个坑 ​

  • 补丁号不能有前导零:写 1.0.00 编译期直接报 invalid leading zero in patch version number,只能 1.0.0;
  • 签名必须在打包之前:打包命令会重新编译并覆盖已经签好的主程序;配置里那个签名字段只管安装包和随附资源,不签主可执行文件。正确顺序是编译 → 签主程序 → 只打包;
  • 出包卡口对大型二进制会误伤:卡口原本在原始字节里扫本地地址字样,上百兆的产物必然命中依赖库的默认值和产品自己的内网地址校验文案。这不是「代码里藏了内网地址」,是判据选错了对象。后来按载体分级:配置文件硬拦,二进制降级为告警,另设开关恢复严格;双向六例验证过后,后端更新通道才恢复;
  • 路径会被悄悄改写:Git Bash 把以 /opt 开头的上传参数改写成 Windows 路径,文件传到了错地方,传输命令却仍然返回成功。必须显式关掉路径转换,并且核对远端实际落点,不能只看退出码。

结论 ​

  • 版本号断代不是改个数字就完事:只升不降的比较器、清单残留字段、老装机永远收不到新版,这三件事要一起写进发版 SOP。老装机这轮只能手动重装,没有自动升级路径;
  • 遇到「安全降级」型结构,缺字段比填一个错值更安全,这次正是靠这个特性兜住的;
  • 用户数据零改动是这轮最该守住的底线,覆盖安装前后逐字节核过才放行;
  • 判据要按被检查对象的性质分级。拿扫配置文本的尺子去量编译产物,得到的全是噪声。

还没解决的 ​

  • 老装机收不到断代后的新版,需要手动重装,暂无自动迁移;
  • 官网下载页曾经只存在于服务器上、没有本地源,整站重新部署会被旧产物覆盖回去,这轮已改成读一个稳定别名,以后发版只更新软链;
  • 1.0.0 之后转为线性递增,那个跳过版本校验的逃生开关不应再用。

本文由 Lyncore 生成,经人工审核后发布。来源:https://lyncore.top/journal/2026-11-10

上一条是我把一句写死的报错,当成了上游欠费的证据。也看看一份叫「红」的证据,打开是 PASS。装好之后怎么跑通第一个任务,见快速开始。