发生了什么
免套餐是一种带免费使用时长的套餐:运营在后台配一条套餐,选套餐分类、填免费天数等,用户兑换后就能在对应天数内免费使用。一条配置在系统里保存了两部分内容:页面上可以逐项修改的字段,比如套餐分类;以及一份把整条配置序列化后的快照。用户兑换时,系统读的是这条配置的数据,按其中记录的套餐分类套用兑换规则、算出实际天数。
配置页有一个“复制”按钮,用来照着一条已有配置快速新增。它的做法是:先按被复制那条配置的编号调详情接口,再把详情接口返回的整份响应直接当作新增请求提交。运营随后在新增页把套餐分类、天数改成需要的值并保存。正常情况下,保存下来的应该是一条分类和天数都是新值的配置。
这次,运营复制了一条已有配置,改了套餐分类后提交,保存下来的分类却还是被复制那条的。新增页的字段绑不到那份快照,快照里保留的是来源配置的分类,而它又跟着整份响应一起进了新增请求。用户兑换时按这个旧分类执行,实际给出的免费天数与配置的本意对不上:既有比配置少的,也有比配置多的。
影响面按数据表现看:389 笔只有一个不被业务读取的关联编号对不上,没有实际影响,也没有资损;198 笔实际可用天数少于配置,涉及 57 名用户,用户在修复前会觉得免费期提前结束,未产生资损;58 笔天数多于配置,其中 37 笔在到期前已订正,21 笔用户可能多用,按采购均价每天 7 元估算约 147 元。修复方向是新增时不接收这份快照,并订正历史配置与已兑换订单的数据;程序修复和订正的上线与验证状态待确认。
本质
两个动作叠在一起,页面上的修改才静默失效。
- 复制时,前端按来源配置的编号取详情,拿到的是“一条完整配置”:既有页面展示的字段,也有那份不该出现在新增请求里的整条配置快照。
- 新增页只渲染可编辑字段,快照没有对应的输入项,运营改分类、改天数都碰不到它。
- 提交时,前端把整份详情响应原样作为新增请求体发出去,快照也就一起到了后端。
- 后端在新增逻辑里判断:请求里存在快照,就直接采用快照里的配置。快照来自被复制的那条旧配置,分类是旧的,页面上改的新分类没有成为保存后的值。
- 兑换时,程序读这条配置的数据取分类,取到的仍是旧分类,于是按旧分类的规则算天数,实际发放与配置本意不符。
复制入口把“详情响应”直接当成了“新增请求”,后端又以“字段存在”为由优先采用它,页面上的修改就静默失效了。
修复方向有两步:新增时不接收快照,分类等一律以请求里显式提交的字段为准,需要快照时按本次提交的字段重新生成;历史数据按配置和已兑换订单分别订正。这两步的上线与验证状态待确认。
下面的 Java 代码为脱敏教学示例,用于说明“整份详情响应被当成新增请求、后端按快照保存”的机制与改法,不代表实际项目源码或已上线实现。
错误代码
// 新增免套餐配置:请求里带着复制来源的整条配置快照(示意)
public void createPackageConfig(PackageCreateRequest request) {
PackageConfig config = new PackageConfig();
config.setCategoryId(request.getCategoryId());
config.setFreeDays(request.getFreeDays());
// 为什么错:把“请求里存在快照”当成“要按快照保存”,
// 而快照是复制来源那条旧配置,分类也是旧的
if (request.getConfigSnapshot() != null) {
config = parseConfig(request.getConfigSnapshot());
}
// 为什么错:落库的是快照解析出的对象,页面提交的分类被覆盖
packageConfigDao.insert(config);
}
修复代码示例
public void createPackageConfig(PackageCreateRequest request) {
PackageConfig config = new PackageConfig();
config.setCategoryId(request.getCategoryId());
config.setFreeDays(request.getFreeDays());
// 修复:新增只认页面显式提交的字段,需要快照时按本次提交的值重建
config.setConfigSnapshot(buildSnapshot(config));
// 兜底:请求里仍带快照,说明调用方还是旧提交方式,记日志后忽略
if (request.getConfigSnapshot() != null) {
log.warn("create ignore client snapshot, categoryId={}", request.getCategoryId());
}
packageConfigDao.insert(config);
}
下次遇到这些场景要警惕
- 做“复制”“另存为”这类入口时:把详情响应里的字段逐个对照新增页,凡是页面不能编辑的字段都不要原样带进新增请求;构造一次改分类的复制新增,保存后回详情核对分类是不是新值。
- 后端新增接口写“字段有值就用”的分支时:先确认这个字段是否只该出现在查询响应里;把“存在”当成“用户要改”,复制来的旧值就会写进新记录。用同一份请求分别带、不带快照提交,比对落库结果。
- 一条业务数据同时有可编辑字段和序列化快照时:查清兑换、计费等读取方到底读哪一份;只改其中一份,就会出现页面看到的与实际执行的不一致,改动后要同时校验两份。
- 配置类改动做回归时:不要只看新增保存成功,要用新配置完整走一次兑换,核对实际发放天数与配置一致,而不是只验接口不报错。