发生了什么
电柜是投放在点位上的资产,一台柜子从一个仓库挪到另一个点位,走的是资产调拨:先在源仓库做调拨出库,柜子进入运输中;运到目标点位后,再在调拨入库页面扫码签收,柜子的归属位置改成目标点位,状态不再停留在运输中。签收之前,程序会先读一遍柜子当前的状态,只有处于运输中的柜子才允许签收——这道校验本来是为了保证只有真正出库在途的柜子才能被签收。柜子的状态和归属都记在资产表里,一条记录对应一台柜子。
正常一笔调拨是这样的:出库操作完成后,柜子记录的状态变成运输中;到点扫码,校验读到运输中,签收通过,记录落到目标点位。
这次不一样。运营人员把这台柜子从同城仓调拨到点位,出库已经做完,到点在调拨入库页面扫码,页面直接提示“电柜不在运输中,无法签收”,签收做不下去。核对数据发现,柜子的信息在系统里有两张表:新的电柜资产表里,这台柜子的状态已经变成运输中;老的资产表里,这条记录没有跟着变,还停在一个 500 上。500 是另一套系统定义的编码,不在资产侧的状态机里。而调拨入库当时做校验,读的正是老的资产表,读到 500,和运输中对不上,签收就被拒了。
确认的影响是这台柜子的调拨停在“已出库、未签收”,目标点位没法在系统里完成收货。是否还有别的柜子受同一问题影响,记录里没有说明。老表为什么没有跟着更新,也还没有定位到具体的写入入口,只确认两张表之间存在数据不同步。
本质
一句话:校验读的不是状态被写入的那张表,读到一个永远不会等于运输中的旧值,签收就被自己的前置校验挡住了。
- 同一台柜子在两张表里各有一份记录:老的资产表和新的电柜资产表。
- 调拨出库之后,新表里这台柜子的状态改成了运输中。
- 调拨入库签收时,程序先查柜子状态,查的是老表。老表这条记录的状态没有跟着变更,停在 500。
- 校验的写法是“状态等于运输中才放行”。500 不是本系统状态机里的值,跟运输中永远不相等,于是走拒绝分支,抛出“电柜不在运输中,无法签收”。
- 校验本身没有错,错在数据源:新表说运输中,校验按老表说不在运输中,同一台柜子的两份记录给出相反结论。而报错文案只讲业务状态,把排查方向引向“是不是没做出库”,掩盖了真正的原因。卡住签收的不是业务状态,而是校验读了一张没有随调拨更新的表。
修复方向是:把电柜信息的读取入口统一切到新的电柜资产表,由新表统一对外提供电柜信息;切换过程中按业务编号比对两张表的状态,把只在新表更新过的记录补齐。另外可以对不属于本系统状态机的编码单独报错并告警,不再让它落进“不在运输中”这条普通业务分支。这些改动是否已经上线、是否覆盖了所有仍读旧表的入口,记录里没有说明。
错误代码
// 调拨入库扫码签收(脱敏教学示例)
public void signIn(String transferNo, String cabinetNo, String targetSite) {
// 为什么错:这里查的是老的资产表,
// 而调拨出库的状态只写进了新的电柜资产表
OldAsset asset = oldAssetMapper.selectByAssetNo(cabinetNo);
Integer status = asset == null ? null : asset.getStatus();
// 为什么错:老表这条记录停在 500。500 是另一套系统定义的编码,
// 本系统状态机里没有这个值,永远不会等于「运输中」,
// 于是签收被这道前置校验直接拒绝
if (!Objects.equals(status, CabinetStatus.IN_TRANSIT.getCode())) {
throw new BizException("电柜不在运输中,无法签收");
}
// 后续步骤:真正要改的状态在新表里
cabinetAssetMapper.moveToSite(cabinetNo, targetSite);
transferOrderMapper.markSigned(transferNo);
}
修复代码示例
// 同一入口:改读状态真正被写入的表(脱敏教学示例)
public void signIn(String transferNo, String cabinetNo, String targetSite) {
// 修复:电柜信息只以新的电柜资产表为准,
// 出库写的是它,入库校验也读它
CabinetAsset asset = cabinetAssetMapper.selectByCabinetNo(cabinetNo);
if (asset == null) {
throw new BizException("电柜资产记录不存在,无法签收");
}
Integer status = asset.getStatus();
// 修复:不认识的状态码单独报错并告警,
// 不再和「不在运输中」这种业务状态混在一个分支里
if (status == null || !CabinetStatus.isKnown(status)) {
log.error("unknown cabinet status, cabinetNo={}, status={}", cabinetNo, status);
throw new BizException("电柜状态异常,请核对资产数据");
}
// 修复:只认本系统状态机里的运输中,判断依据和写入方一致
if (status != CabinetStatus.IN_TRANSIT.getCode()) {
throw new BizException("电柜不在运输中,无法签收");
}
cabinetAssetMapper.moveToSite(cabinetNo, targetSite);
transferOrderMapper.markSigned(transferNo);
}
下次遇到这些场景要警惕
- 给同一个业务对象新增第二张表时:先把所有会读这个对象的入口列出来,接口、定时任务、签收这类前置校验都要算;再构造一条只在新表更新过的记录,把出库到签收整条流程跑一遍,观察每个入口给出的结论是否一致。
- 校验报“不在某某状态”时:别先怀疑业务没走到这一步,先把校验实际读到的状态值和来源表打出来;如果状态值是别的系统定义的编码,基本可以判定读错了数据源。
- 线上出现不属于本系统状态机的状态码时:让它走单独的异常分支并告警,不要落进“不满足条件”的普通判断,否则日志里只剩一句业务提示,排查会被带偏。
- 新旧两张表并行期间:按业务编号定期比对两张表的状态,发现不一致就列出来补数;比对干净之前不要只切一半入口,否则同类问题会在剩下的入口上再出现一次。