发生了什么
充电网点要向房东支付场地租金和电费。签合同时,运营人员在网点签约页上填写收款方户名,页面能看到房东户名、租金收款方户名、电费收款方户名这几栏,填的就是这笔钱付给谁、账户名怎么写。合同保存后,系统同时留一份合同快照——快照是签约时合同内容的副本,出账和打款读的是这份副本,图的是合同后续被改动时账单依据不变。正常流程是:页面上填什么,主表和快照就存什么,账单按这份户名出账,打款前再拿户名和商户登记的主体全称比对,一致才付得出去。
这次出问题的是一个个体工商户的收款方。它的登记全称有 32 个字符,末尾带“(个体工商户)”这样的后缀。签约页的户名输入框设了 30 个字符的上限,运营把全称填进去,超出的部分被输入框直接裁掉,只剩前 30 个字符,末尾的后缀缺了一截。保存这一步没有拦下来:主表存了裁短后的户名,快照照抄一份,账单也就按这个短名字出了。
到了打款这一步,系统拿账单上的收款方户名和商户实际登记的主体全称比对,两个名字差了几个字符,比对不通过,这笔账单付不出去。事后订正存量数据时,主表和快照表里各有 7 条记录的户名被改回完整的 32 字符。
本质
问题不在打款规则,而在签约这一步就把户名存坏了。
- 签约页给户名输入框设了 30 个字符的上限,这个上限小于真实主体全称的长度(这一家是 32 个字符)。
- 运营填进去的是完整全称,输入框在提交前把超长部分裁掉,提交出去的值已经是 30 个字符。
- 后端收到这个值后原样落库,既不校验它和商户登记的主体全称是否一致,也不在长度超限时拒绝。主表存下裁短值,快照由合同内容复制,同样存下裁短值。
- 出账时账单读的就是这份裁短的户名,账单上的收款方于是成了短名字。
- 打款前的校验按户名全等比对,短名字永远对不上完整全称,校验判为失败,账单停在无法支付。
长度上限比真实数据短时,输入框静默裁掉几个字符,后面所有按全名精确比对的地方都会失败,而失败落在打款这种最后一步。
修复分两头:存量数据已由后端订正,主表和快照里被截断的户名改回完整全称;录入侧的上限还没改,产品侧已经提出需求,前端待处理。也就是说,存量账单可以继续付,但同样的户名再录一次,仍可能被裁短。修复是否全部上线、订正后有没有重新发起打款并支付成功,现有信息没有说明。
下面的 Java 代码为脱敏教学示例,用于解释“长度上限截断户名、落库不校验导致打款失败”的机制与改法,不代表实际项目源码或已上线实现。
错误代码
// 签约保存(示意):把页面提交的户名直接落库
public class ContractService {
private static final int PAYEE_NAME_MAX = 30; // 为什么错:上限小于真实主体全称长度
public void saveContract(ContractForm form) {
String payeeName = form.getRentPayeeName();
// 为什么错:超长就截掉尾部,末尾的“(个体工商户)”被丢掉;
// 页面已按 maxlength 裁过一次,这里再裁一次也不会报错
if (payeeName != null && payeeName.length() > PAYEE_NAME_MAX) {
payeeName = payeeName.substring(0, PAYEE_NAME_MAX);
}
Contract c = Contract.of(form, payeeName);
contractRepo.insert(c); // 主表存裁短值
snapshotRepo.insert(Snapshot.of(c)); // 快照照抄,同样裁短
}
}
// 打款前校验:按户名全等比对
public boolean canPay(Bill bill) {
String registered = merchantClient.getRegisteredName(bill.getMerchantId());
// 为什么错:截断后的户名与登记全称永不相等,
// 且只返回 false,不说明是哪个字段对不上
return bill.getPayeeName().equals(registered);
}
修复代码示例
public class ContractService {
// 修复:上限覆盖真实主体全称,示意的 120 需按业务实际最长名称确认
private static final int PAYEE_NAME_MAX = 120;
public void saveContract(ContractForm form) {
String payeeName = form.getRentPayeeName().trim();
if (payeeName.length() > PAYEE_NAME_MAX) {
// 修复:超长直接拒绝,把字段和长度带回去,不再静默截断
throw new BizException("收款方户名超出可保存长度: " + payeeName.length());
}
String registered = merchantClient.getRegisteredName(form.getMerchantId());
if (!payeeName.equals(registered)) {
// 修复:签约时就比对商户登记主体,不一致当场拦下,别等到打款
throw new BizException("收款方户名与商户登记主体不一致");
}
Contract c = Contract.of(form, payeeName);
contractRepo.insert(c);
snapshotRepo.insert(Snapshot.of(c)); // 只存校验通过的值
}
// 存量订正:按商户登记主体回填被截断的户名(示意)
public void fixTruncatedPayee() {
for (Contract c : contractRepo.findPayeeNameShorterThanRegistered()) {
contractRepo.updatePayeeName(c.getId(), c.getRegisteredName());
snapshotRepo.updatePayeeName(c.getId(), c.getRegisteredName());
}
}
}
下次遇到这些场景要警惕
- 给名称类字段设长度上限时:先取真实最长的主体全称(带“(个体工商户)”“分公司”这类后缀,括号全角半角都有),数清字符数再定上限;构造一条刚好超长的数据提交,看它是被拒绝还是被悄悄裁掉。
- 前端和后端各有限长时:确认两处上限一致,且超长有明确提示。输入框的 maxlength 会让人以为“填完了”,实际提交的是裁剪后的值,要比较输入值和最终提交值。
- 同一份数据存在主表和快照两份时:签约、重签、改户名的每条路径都要同时改两份;用“户名长度与登记全称不一致”的条件扫一遍存量,看还有多少条被裁短。
- 下游按字符串全等做校验时:校验失败要报出具体字段和两边的值,否则页面上只有“校验失败”四个字,得从签约页一路查到打款才找得到原因。