发生了什么
两轮业务里,物资需要从一个地点调到另一个地点,系统里对应一次调拨操作:发起方选择调出地址和调入地址,再提交。调拨不是任意两个地址之间都能做,平台按大区划定范围,只允许同一个大区内部互相调拨。
地址在组织架构里对应一个节点。组织架构是一棵树,大区是这棵树的根节点,根下面还有若干层分组节点,地址挂在更下一层。要知道一个地址属于哪个大区,就得从它所在的节点出发,沿父节点一路向上,一直走到根节点。
正常流程是:操作人提交调拨时,系统分别查出调出地址、调入地址所属的大区,比较两个大区是否相同;相同就放行,不同则提示非大区内调拨并拒绝这次提交。
这次两个地址实际同属一个大区,提交后系统却提示非大区内调拨,没有放行。排查后定位到大区查询接口:它按地址找到组织节点后,只取了该节点的直接父节点就返回,没有继续向上走到根节点,于是把上一层分组当成了所属大区。两个地址虽然同根,但挂在根下不同的中间层节点上,直接父节点并不相同,比较结果自然是不相等。
本质
问题出在“取哪一层节点来代表大区”这一步,后面的大区比较本身没有错。
- 组织架构是一棵树,大区是根节点,中间还有若干层分组节点,地址节点挂在下面。一个地址属于哪个大区,要看它沿父节点向上走到的根。
- 提交调拨时,校验程序拿调出地址、调入地址分别调用大区查询接口,期望得到各自的大区标识。
- 接口实现只查了当前节点的直接父节点就返回,没有把父节点继续向上回溯到根。它返回的是某个中间层分组,不是大区。
- 两个地址恰好挂在同一个大区下不同的中间层节点上,它们的直接父节点不是同一个。校验程序比较这两个返回值,得到不相等。
- 校验程序据此判定两个地址不在同一大区,弹出非大区内调拨的提示,这次调拨被拦住。
换句话说,把直接父节点当成所属大区,只要两个地址不在同一个中间层分组,就会被误判成跨大区。组织树层级越多、节点调整越频繁,这种误判越容易出现。修复方向是让大区查询接口沿父节点一路回溯到根节点再返回,并加上环路检测和层级上限;校验程序仍然比较两个根节点标识。目前只把情况反馈给了开发方,没有给出实际改动和验证结果,修复上线状态待确认。
下面两段 Java 为脱敏教学示例,用于对比“只取一层父节点”和“回溯到根节点”,不代表实际项目源码或已上线实现。
错误代码
// 大区查询接口:按地址找到组织节点后,只取直接父节点
public String queryRegionId(String siteId) {
Site site = siteRepository.findById(siteId);
OrgNode node = orgClient.getNode(site.getOrgNodeId());
OrgNode parent = orgClient.getParent(node.getNodeId());
// 为什么错:父节点只是上一层的中间分组,不是这棵树的大区根节点
return parent.getNodeId();
}
// 调拨校验:比较两个地址的“大区”
public void checkSameRegion(String fromSiteId, String toSiteId) {
String fromRegion = regionService.queryRegionId(fromSiteId);
String toRegion = regionService.queryRegionId(toSiteId);
if (!Objects.equals(fromRegion, toRegion)) {
// 为什么错:同根不同父的两个地址在这里被当成跨大区
throw new BizException("非大区内调拨");
}
}
修复代码示例
// 修复:沿父节点一路回溯到根节点,根节点才是所属大区
public String queryRegionId(String siteId) {
Site site = siteRepository.findById(siteId);
OrgNode node = orgClient.getNode(site.getOrgNodeId());
Set<String> visited = new HashSet<>();
while (node.getParentId() != null) {
if (!visited.add(node.getNodeId())) {
throw new IllegalStateException("组织架构存在环: " + node.getNodeId());
}
node = orgClient.getNode(node.getParentId()); // 继续向上,不在第一层停住
}
return node.getNodeId();
}
// checkSameRegion 不变,仍比较两个根节点标识;示意写法,未运行
下次遇到这些场景要警惕
- 做“同大区才能操作”这类层级判断时,先构造两个同根、但直接父节点不同的地址提交一次业务,观察校验是否放行。只测同一个父节点下的两个地址,会漏掉这一类错误。
- 给组织架构查询接口定契约时,写清返回的是直接父节点、完整祖先链还是根节点;调用方按语义使用,不要把 parentId 直接当 regionId 参与比较。
- 组织树新增层级、搬迁节点或调整大区归属后,把所有依赖层级的规则都过一遍,包括调拨范围、权限范围和归属统计,确认判断取的是根节点而不是固定层数。
- 校验失败的提示里带上双方解析出的大区标识或节点路径,出现争议时能快速区分真的跨区和层级取错。