发生了什么

电池在资产系统里同时记着两件不同的事。一件是物权状态,说明这颗电池当前算哪一类资产:是可以对外投放的良品,还是等待维修、处置的不良品。仓储人员按这个状态决定电池放在哪个仓、能不能调拨。另一件是故障状态,说明这颗电池当前有没有带故障标记,由故障上报和维修流程维护。故障处理完成之后,业务会在后台做一个“消标”动作,把故障标记去掉。

正常流程是这样的:一颗电池报出故障,被移入不良品仓;维修或检测完成后,业务在后台执行消标,故障状态改为正常;物权状态随之改回良品;仓储人员再把电池从不良品仓调拨进良品仓,这颗电池重新进入可投放的资产池。

这次不一样的地方就在消标这一步。一块电池在不良品仓完成消标,后台返回成功,故障标记确实被去掉了。但它的物权状态仍然是“不良品”。仓储人员按常规操作,把这颗电池从不良品仓调拨到良品仓,系统校验物权状态,判定它不属于良品,直接报错,调拨没有成功。

结果是一颗故障已经消掉、本可以继续使用的电池被留在不良品仓里出不来。对外表现出来的情况自相矛盾:故障已经清掉,系统仍然按坏电池对待它。这一次操作的影响只到这块电池本身;影响范围和处理结果,记录里没有更多说明。

本质

一句话:消标只改了故障状态,没有改物权状态,后面的调拨按物权状态做准入判断,读到的是没变的旧值,于是把这颗电池挡在良品仓外面。

  1. 电池因故障被移入不良品仓时,物权状态被写成不良品,这一步在当时是对的。
  2. 后台消标程序执行时,更新故障状态、写入消标记录,接口返回成功。
  3. 同一次消标里没有更新物权状态,这一步被漏掉了。从这一刻起,描述同一颗电池的两个状态开始互相矛盾:故障状态是正常,物权状态还是不良品。
  4. 仓储人员发起从不良品仓到良品仓的调拨,调拨入口按物权状态判断这颗电池是否允许进入良品池。
  5. 读到的是不良品,接口抛出业务异常,调拨失败,电池留在原仓。

消标接口返回成功,只说明故障标记去掉了,不说明这颗电池的物权状态也一起改好了。

根子在职责划分:两个状态字段描述同一个对象,却由不同流程各自维护,没有任何一处保证它们同时发生变化。消标流程把自己理解成“只负责清掉故障标记”,物权状态留给别的流程处理,而实际业务里没有第二个流程来补这一步,于是两条状态慢慢走散。

修复方向是:故障电池消标时,在同一次处理里同步把物权状态改回良品,两处更新要么都生效、要么都不生效;对已经分叉的数据,按故障状态重新推一遍物权状态;更长远的做法是把“这颗电池现在算什么资产”收敛到单一来源,或者在调拨入口加一致性校验和明确提示,避免同类问题再次被当成“状态不对、无法调拨”处理。修复是否上线、存量数据怎么清理,记录没有说明。

错误代码

public class BatteryFaultService {

    // 后台消标入口:把故障标记去掉
    public void clearFaultMark(String batteryNo, String operator) {
        BatteryAsset asset = assetMapper.selectByNo(batteryNo);
        // 为什么错:只把故障状态改成正常,物权状态原样留着,
        // 接口照样返回成功,两个状态从此不再一致
        assetMapper.updateFaultStatus(asset.getId(), FaultStatus.NORMAL);
        faultLogMapper.insert(new FaultLog(asset.getId(), operator, "CLEAR"));
    }
}

修复代码示例

public class BatteryFaultService {

    // 修复:消标与物权状态回写放在同一个事务里
    @Transactional(rollbackFor = Exception.class)
    public void clearFaultMark(String batteryNo, String operator) {
        BatteryAsset asset = assetMapper.selectByNo(batteryNo);
        assetMapper.updateFaultStatus(asset.getId(), FaultStatus.NORMAL);
        // 修复:故障消掉后物权状态同步回到良品,
        // 调拨入口才不会拿旧状态把电池挡在良品仓外
        assetMapper.updateOwnershipStatus(asset.getId(), OwnershipStatus.GOOD);
        faultLogMapper.insert(new FaultLog(asset.getId(), operator, "CLEAR"));
    }
}

两段代码是脱敏教学示例,用来说明错误与修复思路,不代表实际项目源码或已上线实现。表名、状态枚举和取值均为示意。物权状态能否直接改成良品,取决于业务对“消标之后是否可投放”的定义,如果还要经过检测或入库环节,就要把这一步放在真正确认可用的节点上,而不是简单地在消标时统一改掉。

下次遇到这些场景要警惕

  • 一个对象上挂着多个由不同流程维护的状态时:先把字段和负责修改它的流程列成一张表,确认每个流程结束后它们是否仍然自洽;入不良品仓、消标、调拨这类动作各执行一次,每次都回查全部状态字段。
  • 用某个状态做准入校验的入口:校验不通过时把实际读到的值和判断条件一起打出来,不要只提示“不满足条件”,否则分不清是业务上确实不允许,还是上游少改了一个字段。
  • 发现两条状态互相矛盾的数据时:先按业务事实判断哪条是真的,例如故障到底有没有消掉,再决定改哪条;同时扫一遍同类记录,确认还有多少颗电池卡在同样的状态里,不要只修反馈的这一颗。
  • 补了同步动作之后:把“报故障、入不良品仓、消标、调拨入良品仓”整条流程完整走一遍,逐节点确认两个状态都符合预期,再考虑放开给仓储人员批量操作。