发生了什么
换电柜要放在城市里的点位上,这个点位在业务里叫网点。网点占用的场地是从房东那里租的,双方签一份场地租赁合同。合同里除了租期和月租金,还分别约定两笔钱怎么结算:租金多久付一次,可取月付、季付、年付;电费怎么付,通常是按月付。后台有一个网点合约详情页,运营、资产和财务人员打开它核对一份网点合同的条款。
这个页面读的不是正在使用的合同主数据,而是签约时留下的一份合同快照:把签约当时的条款按字段抄一份存起来,之后合同再调整,历史页面看到的内容也不会跟着变。正常时,页面上每个展示项只读自己对应的那个快照字段:租金支付周期读租金一侧的字段,电费支付周期读电费一侧的字段。多数合同不会单独存电费的支付方式,因为约定就是按月付(也就是常说的月结),页面遇到这种空值时按这个默认值展示。
七月底,为了在网点合约页上做合同状态检查,开发调整了这个详情页组装数据的方式。需求和技术方案只写了合同状态这一项,其他字段怎么取没有写明。实现时,租金支付周期不再读原来的租金支付方式,改用快照里的场地周期字段。
上线半个月后,一线同事查看一份网点合约时发现,页面上的电费支付周期一栏显示的是这份合同的租金支付周期。电费本来按月付,这一栏正常显示的就是默认的月付,这次却变成季付或年付,看页面的人会以为电费也改成了按季、按年结算,或者以为合同条款被人改过。反馈当天修了一版;几天后,同一张页面又报出线下合同照片一栏是空的,第二次修复在三天后合入。问题单状态为已完成,记录没有给出修复后的验证结论。
本质
一句话:详情页组装时,电费支付周期这一项取了租金那一项的值,而它自己的快照字段本来就是空的,本该回填默认的月付。
- 快照按字段存着两笔费用各自的结算约定:租金一侧有支付方式,也有这次改用的场地周期;电费一侧的支付方式多数为空。
- 这次改动把租金支付周期的来源换成了场地周期,取到的这个值在组装详情时被两个展示项共用了。
- 电费支付周期没有去读自己的字段,而是直接复用了租金周期的变量;连"为空就回填默认值"的判断也写在这个变量上——只要租金周期有值,它就原样当成电费支付周期返回。
- 于是响应里的电费支付周期等于租金支付周期,前端拿到什么就渲染什么,页面看上去像是电费的结算方式被改了。
- 快照里电费支付方式为空这个事实没有起作用:默认月付的分支根本走不到,默认值形同虚设。
这个过程不会报错:接口正常返回,两个值也都是合法的周期取值,只有把同一份合同的这两个字段并排看,才会发现它们一模一样。一个展示项取了另一个展示项的值,页面不会报错,只会安静地显示错误内容。
修复是让每个展示项回到自己的字段:租金支付周期用快照里的租金支付周期赋值,电费支付周期读电费支付方式,为空时返回默认的月付。下面两段 Java 代码是按上述机制写的教学示例,只对比两个周期字段的取数方式,不代表实际项目源码或已上线实现。
错误代码
// 网点合约详情组装(Java 教学示例)
public class SiteContractDetailAssembler {
private static final String DEFAULT_PAY_CYCLE = "月付";
public SiteContractDetailVO assemble(SiteContractSnapshot snapshot) {
SiteContractDetailVO vo = new SiteContractDetailVO();
vo.setMonthlyRent(snapshot.getMonthlyRent());
vo.setElectricityPrice(snapshot.getElectricityPrice());
// 需求要求租金周期改用“场地周期”字段
String rentPayCycle = snapshot.getSiteCycle();
vo.setRentPayCycle(rentPayCycle);
// 为什么错:电费支付周期复用租金周期的变量,没有读快照里的电费支付方式;
// 为空判断也写在这个变量上,电费自己的空值永远走不到默认月付
vo.setElectricityPayCycle(
rentPayCycle == null || rentPayCycle.isEmpty()
? DEFAULT_PAY_CYCLE
: rentPayCycle);
return vo;
}
}
修复代码示例
// 网点合约详情组装(Java 教学示例,修复版)
public class SiteContractDetailAssembler {
private static final String DEFAULT_ELECTRICITY_PAY_CYCLE = "月付";
public SiteContractDetailVO assemble(SiteContractSnapshot snapshot) {
SiteContractDetailVO vo = new SiteContractDetailVO();
vo.setMonthlyRent(snapshot.getMonthlyRent());
vo.setElectricityPrice(snapshot.getElectricityPrice());
// 租金一项只读租金支付周期(场地周期)
vo.setRentPayCycle(snapshot.getSiteCycle());
// 电费一项只读自己的字段,为空时回填默认月付
vo.setElectricityPayCycle(
resolveElectricityPayCycle(snapshot.getElectricityPayCycle()));
return vo;
}
private String resolveElectricityPayCycle(String snapshotValue) {
// 快照里没有存电费支付方式时,返回默认月付,不借用别的字段
return (snapshotValue == null || snapshotValue.trim().isEmpty())
? DEFAULT_ELECTRICITY_PAY_CYCLE
: snapshotValue;
}
}
下次遇到这些场景要警惕
- 给详情页的展示项更换取数字段时,先把页面上每一项与快照字段列成对照表,写清"读哪个字段、为空时显示什么",再动代码;改完拿一份真实合同,把页面上的值和快照里对应的字段逐个比对。
- 所有"为空时取默认值"的分支,都要确认判断的是这一项自己的变量,并用一份该项为空的合同完整走一遍页面;默认分支如果从来没被走到,记录里就会出现别的字段的值。
- 一个页面同时改了几处取数,回归不要只测报障的那一处;同一批改动里相邻的字段一起看,本案例第一次修完几天后,同一页面又发现了线下合同照片一栏为空。
- 对周期这类取值有限的字段,接口返回前按取值集合做一次校验;出现不属于该字段的值,或者同一份合同的两个周期字段完全相等,就记日志并告警,不要等业务看页面时发现。