发生了什么
一张账单下面,应该能看到组成这张账单的每一笔明细。但用户查看时发现:账单已经结算,其中一笔明细却没有显示在账单里,还留在“待出账”列表。
款项已完成结算,出错的是这笔明细在系统里的归属和展示。
本质
系统里保存一条明细时,会给它一个唯一编号。以后要修改这条明细,就需要找到对应的编号。
这次的过程是这样的。下面用 A、B 代替实际编号,只为说明过程:
- 这笔明细先被保存进系统,编号是 A。当时账单还没生成,所以它暂时不属于任何账单。
- 后来账单生成了,系统需要把这笔已有明细放进账单,却又为它生成了一个新编号 B。
- 系统检查后知道“这笔明细已经有了,不用再创建”,于是准备修改原来的记录。
- 但修改时用的却是 B。系统里原来那条记录的编号是 A,按 B 找不到它,所以根本没有改成功。
- 程序没有检查修改是否成功,这笔明细就一直没有被放进账单。
要修改已经存在的明细,就应该用它原来的编号,不能用刚生成的新编号。
需要修正异常明细,并让更新使用已存在的明细编号。修复上线状态待确认。
错误代码
BillDetail incoming = new BillDetail();
incoming.setId(idGenerator.nextId()); // 为本次同步生成新编号 B
incoming.setBillId(message.getBillId());
BillDetail existing = mapper.findByBusinessKey(message.getBusinessKey());
if (existing != null) {
mapper.updateBillId(incoming); // 错:传入的是 B,已有记录编号是 A
}
修复代码示例
BillDetail existing = mapper.findByBusinessKey(message.getBusinessKey());
if (existing == null) {
mapper.insert(toNewDetail(message));
return;
}
// 用查到的旧记录编号 A 更新,而不是本次生成的编号 B。
int rows = mapper.bindToBill(existing.getId(), message.getBillId());
if (rows != 1) {
throw new IllegalStateException("账单明细更新失败");
}
BillDetail 表示一条账单明细;Mapper 是执行数据库查询和更新的接口;businessKey 是识别同一笔业务明细的条件;billId 是它应归属的账单编号。示例聚焦已有明细的更新,新建分支还需用业务唯一约束处理并发。
这次更新在数据库里发生了什么? 表名和字段名使用通用名称。
错误 SQL 使用本次新生成的编号 B,数据库里只有编号 A,所以修改了 0 行:
UPDATE bill_detail
SET bill_id = :billId
WHERE id = :incomingId; -- B:库里没有这个编号
修复 SQL 使用刚才查询到的旧编号 A,把已有明细归入当前账单:
UPDATE bill_detail
SET bill_id = :billId
WHERE id = :existingId; -- A:已有明细的真实编号
bill_id 表示“这条明细属于哪张账单”,id 表示“要修改哪条明细”。:参数名表示绑定参数,实际应使用项目的数据访问框架传参。
下次遇到这些场景要警惕
- 数据可能先保存,稍后再补信息:先保存一笔明细,再生成账单,检查原来的明细是否确实进入账单,而不是只测试“账单和明细同时创建”。
- 程序发现旧记录后要修改它:检查后面的修改是否使用了旧记录的编号,不能仍用新生成的编号。
- 接口提示成功:再查一次实际数据,确认该改的记录真的改了。没有找到目标记录时,应明确报错或记录异常,不能直接当成成功。