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} 替换为实际设备编码。我核了两件事:
- 占位符名称逐字一致:SQL 写的是
{unitCode},Java 侧替换的也是unitCode,没有一边写{smCode}一边写{unitCode}的错位 - 硬编码点位只出现在
real_path列(纯追溯用,运行时不读),point_path全是占位符——没违反"点位禁硬编码"的铁律
如果这两条对不上,线上就会拼出一条 root.shaojie.{smCode} 的死路径,设备数据全断。日志里不会报编译错,只有运行时才炸,而且炸的时候你根本不会想到是占位符没对齐。
收尾:新增行 diff 扫描
收尾环节是把 11 个文件的新增行全部过一遍,grep 以下内容:
System.out/printStackTrace:无TODO/FIXME:无- 硬编码密码、内网 IP:无
旧表 SM_QS_P 的残留字段也确认了——只出现在注释和 real_path 追溯列,不影响运行时逻辑。干净。
可带走的核查清单
下次面对"能不能提交"的问题,别只跑编译。按这个顺序过一遍:
- 全量编译(加
-o排除网络变量) - 远程 hash 比对(确认不需要 rebase)
- SQL 配对(正向 + rollback,数据自包含)
- 配置覆盖度(代码引用的每个 key 在 SQL 里都有行)
- 占位符一致性(SQL 和 Java 侧变量名逐字对齐)
- 硬编码扫描(
point_path不得出现具体设备码) - 新增行 diff 扫描(调试代码、密钥、TODO)
七项全绿,再动手 git commit。少走一步,就可能在半夜被电话叫起来修线上,而根因只是某个占位符少写了一个字母。
做自动化这几年,最耗时间的从来不是写代码,是摸清每个平台的脾气。
这篇里提到的坑,都是真金白银踩出来的。
这类坑我还攒了不少,下一篇准备写批量发布的幂等与重试。
想先看哪块,评论区点个名。

浙公网安备 33010602011771号