发生了什么
平台要在一个位置开换电网点,先由一线人员到现场勘察,确认能不能布点。这类候选位置先登记成一条「潜在点位」:还没勘察的在待勘探列表,勘察完成、结论已提交的进入已勘探列表;勘探之后才轮到签约,签约表单里要填商户信息。点位记录上有一个商户编号字段,表示这条点位当前关联哪个商户。
正常流程是:一线人员从待勘探打开勘探页,页面调详情接口,把建点时登记的商户信息带出来;填完现场信息点「新签点保存」,点位推进到签约阶段;如果发现填错,可以执行「勘探回退」,点位回到待勘探后重新出现在列表里,再勘探一次。按设计,回退后的点位仍在勘探阶段,详情接口应继续带出建点时登记的商户编号,保存后回到已勘探列表。
这次不一样。这个点位保存后又回退,再次打开勘探页时,详情接口判断这条点位是否已进入签约阶段,判断错了:回退只把点位放回待勘探列表,判断阶段所依据的数据没有跟着退回去,接口仍按签约阶段处理,返回了签约阶段才该用的另一方商户编号。勘探接口拿这个编号直接保存,点位记录上的商户编号被写成另一个商户。已勘探列表按商户归属展示,编号和建点时登记的对不上,这个点位在列表里就看不到了。
短期是清洗写错编号的存量数据,长期是修详情接口的取值逻辑;记录没有说明是否已上线、存量是否清洗完成。
本质
一句话:勘探阶段和签约阶段共用同一个商户编号字段,「该取哪一方」要靠判断点位当前所处的阶段;回退后判断仍落在签约阶段,勘探保存就把另一方的编号写进了点位记录,列表再按这个错误编号去归属,点位自然不出现。
- 建点时写入初始编号。创建点位时,系统把记录里的商户编号写到点位上,勘探阶段的详情接口本来就该读它。
- 保存勘探结果会把点位推进到签约阶段,同时产生签约草稿,草稿上记着签约表单填的另一方商户编号。同一个字段从此有了第二种含义。
- 回退只把点位放回待勘探,让它重新出现在列表里;但保存那一步在点位上留下的阶段数据,没有跟着退回勘探阶段。
- 再次打开勘探页时,详情接口按仍留在点位上的阶段数据判断,没有看点位当前是否真在签约流程里,于是落到签约分支,返回草稿上的那一方编号。
- 勘探接口把前端带回的编号直接写库,没有和建点编号比对。错误编号覆盖原值;之后按商户归属查已勘探列表,这条点位被归到另一个商户名下,页面看不到。
一个字段承担了两种含义:既是建点时的归属商户,又是签约阶段的一方。阶段判断只要偏一次,写库就没有校验能拦住这个值,最终表现成列表少一条点位,而不是报错。
修复方向是让详情接口按点位真实阶段取值:仍在勘探阶段就返回建点编号,确实进入签约阶段才返回草稿编号;回退、撤销路径还要确认判断依据一起回退。记录只写了修详情接口取值逻辑这一句,没有实际改动,上线状态待确认。
同一个字段在流程不同阶段代表不同主体时,先确认判断当前阶段的依据在回退、撤销之后是否还成立,再决定取哪一份数据。
错误代码
示例中,详情接口查到签约草稿就换成草稿上的编号,勘探接口再把前端带回的编号直接写库。
// 打开勘探表单时预填数据(脱敏教学示例)
public PotentialNodeDetailVO queryPotentialNodeDetail(Long nodeId) {
PotentialNode node = potentialNodeMapper.selectById(nodeId);
Long merchantId = node.getCreateMerchantId(); // 建点时登记的商户编号
TempContract draft = tempContractMapper.selectByNodeId(nodeId);
if (draft != null) {
// 为什么错:只要查到签约草稿就换成草稿上的编号,
// 没有确认点位当前是否仍在签约阶段;回退后判断依据没复位,这里照样覆盖
merchantId = draft.getSignMerchantId();
}
return PotentialNodeDetailVO.of(node, merchantId);
}
// 保存勘探结果(脱敏教学示例)
public void explorePotentialNode(ExploreRequest request) {
// 为什么错:前端回传的商户编号直接落库,没有和点位自身的建点编号比对
potentialNodeMapper.updateMerchantId(request.getNodeId(), request.getMerchantId());
}
修复代码示例
// 修复:详情接口按点位真实阶段取编号(脱敏教学示例)
public PotentialNodeDetailVO queryPotentialNodeDetail(Long nodeId) {
PotentialNode node = potentialNodeMapper.selectById(nodeId);
Long merchantId;
if (potentialNodeStageService.inSigningStage(nodeId)) {
// 修复:确实处于签约阶段,才使用签约草稿上的另一方编号
TempContract draft = tempContractMapper.selectByNodeId(nodeId);
if (draft == null) {
throw new BizException("点位处于签约阶段但缺少签约草稿");
}
merchantId = draft.getSignMerchantId();
} else {
// 修复:勘探阶段以及勘探回退之后,一律沿用建点时登记的编号
merchantId = node.getCreateMerchantId();
}
return PotentialNodeDetailVO.of(node, merchantId);
}
两段代码对应同一处判断:错误版用「有没有签约草稿」代替「当前是否在签约阶段」,回退后点位上的阶段数据没有复位,于是被当成签约阶段;修复版把阶段判断交给当前状态,勘探和回退路径都回到建点编号。记录只给了修复方向,没有实际代码;以上为教学示例,未实施也未验证。勘探保存侧是否要拒收前端编号,取决于产品对阶段边界的定义。
下次遇到这些场景要警惕
- 给一个字段安排两种阶段含义时:先列清每个阶段它该取自哪条记录,再为「保存后回退」「提交后撤销」单独走一遍,确认取值跟着阶段退回去。
- 实现回退、撤销功能时:不要只改主状态;检查上一阶段产生的草稿和关联数据是否还在、是否还参与后续判断,用「保存→回退→再保存」的顺序验证。
- 详情接口给表单预填编号类字段时:保存接口不要盲信前端回传值,用记录自身的归属编号比对一次,不一致时以记录为准并留下告警。
- 列表按归属方过滤时:构造一条归属方被改错的记录,看它出现在谁的列表里、会不会直接消失;对「消失但不报错」补一条数量核对。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名、表名与字段名均为示意。