发生了什么
电柜是投放在城市里的换电柜,一台柜子算哪座城市的资产,由资产数据里的归属城市决定。柜子在城市之间流动时走发货单:发货方填接收城市发出去,柜子运到后由接收方签收。正常一笔发货走完,柜子的归属城市应该等于这张发货单的接收城市,也等于实际签收的城市。
这批柜子的流转多了一步:第一次发货的接收城市是第一座城市,货发出去后这张发货单被撤销;随后业务把接收城市改成第二座城市,重新发货。柜子实际运到第二座城市,接收方签收成功,签收记录上的城市是第二座城市。
问题在资产数据这一侧。这批柜子在第二座城市签收之后,归属城市仍然是第一座城市。排查时确认过,这批柜子期间没有走过调拨单,也没有人在第一座城市对它们做过绑定之类的操作,不是有人把柜子改回去的。
签收记录和资产归属分别指向两座城市,柜子处在货在第二座城市、账在第一座城市的状态。这类不一致不会让签收报错,单据和签收都是成功的,只能靠人把签收记录和资产数据对着比才会发现。记录给出的影响范围是:发货之后撤销、并且把接收城市改掉再重发的单据,都会留下同样的问题。
本质
一句话:撤销发货时只撤了单据和发货数据,没有把柜子的物权归属一起回滚;签收时又没有拿实际收货城市去写归属,两次都默认对方会把城市改对,归属城市就停在第一次发货的那座城市。
- 第一次发货,柜子发往第一座城市。这批柜子当时记的归属城市就是第一座城市,与这张发货单一致。
- 发货单被撤销。撤销程序把单据状态改成已撤销,也把资产侧这批柜子的发货数据撤回。但撤回只处理了发货相关的数据,物权数据没有动,归属城市仍写着第一座城市。
- 改城市重发。新的发货单接收城市是第二座城市,柜子运到后由接收方签收。签收程序记下签收城市和时间,把柜子置为已签收,却没有用收货城市覆盖归属城市,默认资产侧已经写对了。
- 结果。归属城市停留在第一座城市,签收城市是第二座城市。这两个字段描述的是同一件事,却由两个动作各自维护,没有任何一处保证它们相等。
撤销和签收都返回成功,但没有任何一步把归属城市改成实际签收的城市,成功后留下的是一条自相矛盾的资产记录。
根子在职责划分。撤销程序把自己理解成把发货单和发货数据撤掉,签收程序把自己理解成把柜子收下来,归属城市这件两个动作都该管的事,谁都没有管。而且发货单的接收城市允许改,撤销后改城市重发很常见,这条路径没有被单独校验。
修复方向是两条一起改:撤销时同步变更电柜资产数据,把状态置为已撤销,不再带着旧归属继续流转;签收时以实际收货城市取值,覆盖归属城市;对已经错位的存量柜子,按签收记录重算归属。记录没有说明签收取值的改动是否已经上线;撤销相关的改进,按记录内容还在等下个迭代提需求。
下面两段代码为脱敏教学示例,说明错误与修复思路,不代表实际项目源码或已上线实现,表名与枚举均为示意。
错误代码
// 发货单撤销与签收(脱敏教学示例)
public void cancelShipment(String shipmentNo) {
Shipment shipment = shipmentMapper.selectByNo(shipmentNo);
shipmentMapper.updateStatus(shipmentNo, ShipmentStatus.CANCELLED);
for (String cabinetNo : shipment.getCabinetNos()) {
// 为什么错:只把柜子从发货单上撤回,
// 物权数据里的归属城市没有跟着回滚,旧城市继续留在资产上
cabinetMapper.updateShipStatus(cabinetNo, ShipStatus.WITHDRAWN);
}
}
public void signShipment(String shipmentNo, String receiveCity) {
Shipment shipment = shipmentMapper.selectByNo(shipmentNo);
for (String cabinetNo : shipment.getCabinetNos()) {
// 为什么错:签收只记了签收城市和时间,
// 没有用 receiveCity 覆盖归属城市,默认资产侧已经是对的
cabinetMapper.updateSignInfo(cabinetNo, receiveCity, now());
cabinetMapper.updateAssetStatus(cabinetNo, AssetStatus.SIGNED);
}
}
修复代码示例
// 修复:撤销与签收都把归属城市写对(脱敏教学示例)
@Transactional(rollbackFor = Exception.class)
public void cancelShipment(String shipmentNo) {
Shipment shipment = shipmentMapper.selectByNo(shipmentNo);
shipmentMapper.updateStatus(shipmentNo, ShipmentStatus.CANCELLED);
for (String cabinetNo : shipment.getCabinetNos()) {
// 修复:资产数据同步置为已撤销,撤回不留旧归属
cabinetMapper.updateAssetStatus(cabinetNo, AssetStatus.CANCELLED);
cabinetMapper.updateOwnerCity(cabinetNo, shipment.getFromCity());
}
}
@Transactional(rollbackFor = Exception.class)
public void signShipment(String shipmentNo, String receiveCity) {
Shipment shipment = shipmentMapper.selectByNo(shipmentNo);
for (String cabinetNo : shipment.getCabinetNos()) {
// 修复:以实际收货城市作为归属城市,覆盖撤销遗留的旧值
cabinetMapper.updateSignInfo(cabinetNo, receiveCity, now());
cabinetMapper.updateOwnerCity(cabinetNo, receiveCity);
cabinetMapper.updateAssetStatus(cabinetNo, AssetStatus.SIGNED);
}
}
两段代码改的都是同一处:撤销把单据推出来的归属收回去,签收用本次实际收货城市重新落一遍。撤销后归属城市回到哪里要看业务定义,可以退回发货城市,也可以置为未分配,代码里只是示意。
下次遇到这些场景要警惕
- 单据有撤销或作废入口时:先列出这张单据推出来的资产字段,例如归属城市、占用关系、在途状态,然后真正执行一次撤销,逐个字段回查柜子资产记录,不要只确认单据状态变成了已撤销。
- 同一事实存在两个来源时:一边是发货单的接收城市,一边是资产记录的归属城市。构造先发第一座城市、撤销、改发第二座城市、再签收的完整流程,比对签收城市与归属城市是否相等,改城市重发的边界最容易被漏掉。
- 签收这类终态动作:确认它写入的是本次收货的实际值,而不是沿用上游记录里已有的值;对签收完成后归属城市仍与签收城市不一致的柜子,加一条校验或告警,不要等人工比对才发现。
- 排查归属异常时:先查这段时间有没有调拨单和绑定操作,排除人工改动,再回到发货撤销这条路径上,核对资产数据有没有跟着回滚。