11 个改动文件、454 行 SQL:提交前我跑的 7 项硬核查

周五下午,同事在群里 @ 我:"烧结后端那 11 个文件你核完没有?能提就提,下班前要合到 dev。"

我打开终端,git status 显示 11 个改动文件,dev 分支停在 2cc6b93。能不能提交,不是拍脑袋说一句"应该没问题"——我花了大概 20 分钟,跑了 7 项硬核查。全部通过才动的手。

编译和远程状态:257 个源文件 + 一个 hash 比对

最基础的一步:全量编译。

mvn -o clean compile 跑完,BUILD SUCCESS,257 个源文件全部重编,零报错。我特意加了 -o(offline),排除网络波动干扰,确保是本地依赖完整可编译,而不是"刚好缓存命中"的假通过。

远程冲突检查更简单:git rev-parse HEAD 拿到本地 dev 的 hash,和 origin/dev 对比。两边都是 2cc6b93,说明中间没人推过新提交,不需要 fetch 和 rebase,直接 commit + push 不会撞车。

SQL 脚本:454 行插入和 39 行 rollback 怎么配对

这次改动包含 V4.23 的 SQL 脚本。核法不是"看了个大概",而是逐行检查:

  • 正向脚本插入了 454 行配置数据
  • rollback 脚本内嵌了原始 39 行数据,自包含,不依赖外部备份
  • page_code 覆盖了 fxsj(140)、gcscstj(134)、realtime(58)、board、lclw、lcxll、plcjy、stmx 等页面码

关键验证点:代码里 BellowsServiceImpl 和 TrendServiceImpl 引用的每一个 page_code,在 SQL 插入的 454 行里都有对应行。没有遗漏,就不会在运行时查不到配置直接 NPE。

占位符一致性:450 行 root.shaojie.{unitCode} 不会拼出死路径

这是最容易出隐性 bug 的地方。

SQL 里 point_path 列全部写成 root.shaojie.{unitCode},共 450 行。Java 侧两个 Service 在运行时把 {unitCode} 替换为实际设备编码。我核了两件事:

  1. 占位符名称逐字一致:SQL 写的是 {unitCode},Java 侧替换的也是 unitCode,没有一边写 {smCode} 一边写 {unitCode} 的错位
  2. 硬编码点位只出现在 real_path 列(纯追溯用,运行时不读),point_path 全是占位符——没违反"点位禁硬编码"的铁律

如果这两条对不上,线上就会拼出一条 root.shaojie.{smCode} 的死路径,设备数据全断。日志里不会报编译错,只有运行时才炸,而且炸的时候你根本不会想到是占位符没对齐。

收尾:新增行 diff 扫描

收尾环节是把 11 个文件的新增行全部过一遍,grep 以下内容:

  • System.out / printStackTrace:无
  • TODO / FIXME:无
  • 硬编码密码、内网 IP:无

旧表 SM_QS_P 的残留字段也确认了——只出现在注释和 real_path 追溯列,不影响运行时逻辑。干净。

可带走的核查清单

下次面对"能不能提交"的问题,别只跑编译。按这个顺序过一遍:

  1. 全量编译(加 -o 排除网络变量)
  2. 远程 hash 比对(确认不需要 rebase)
  3. SQL 配对(正向 + rollback,数据自包含)
  4. 配置覆盖度(代码引用的每个 key 在 SQL 里都有行)
  5. 占位符一致性(SQL 和 Java 侧变量名逐字对齐)
  6. 硬编码扫描(point_path 不得出现具体设备码)
  7. 新增行 diff 扫描(调试代码、密钥、TODO)

七项全绿,再动手 git commit。少走一步,就可能在半夜被电话叫起来修线上,而根因只是某个占位符少写了一个字母。


做自动化这几年,最耗时间的从来不是写代码,是摸清每个平台的脾气。

这篇里提到的坑,都是真金白银踩出来的。
这类坑我还攒了不少,下一篇准备写批量发布的幂等与重试。
想先看哪块,评论区点个名。

posted @ 2026-11-11 04:54  钱栈up  阅读(8)  评论(0)    收藏  举报