发生了什么
租金电费业务里,网点要按约定把场地租金、电费付给房东。系统按合同生成账单,账单上除了金额和账期,还要写清楚这笔钱付给谁,业务上叫“支付对象”,也就是账单挂的收款商户。账单生成后不会直接打款,要先过一道核对:核对程序检查账单上的收款商户是否存在、是否就是合同上登记的那一家,核对通过的账单才推送到账务系统,进入后续付款流程。
正常情况下,一份合同对应一个支付对象。合同上登记了商户编号、商户名称和统一社会信用代码。生成账单时,程序本应按合同上的支付对象取到那一家商户,把编号和名称写进账单;核对程序再拿账单上的商户与合同比对一次,两边一致就放行。
这次不一样:这批账单对应的合同支付对象,是一家名称里带括号的商户。生成账单时,程序没有直接按合同上的商户编号定位收款商户,而是拿统一社会信用代码去商户资料里查,一次返回了多家商户;接着程序把名称里的括号、空格这类符号去掉再做比较,第一个比中的商户被选中,写进了账单。被选中的这家与合同上的支付对象并不是同一家,两者的名称只差标点。
结果,核对程序拿账单上的收款商户去和合同支付对象比对,发现不是同一家,报出所选账单的房东商户信息缺失,核对不通过。这批账单都没有推送到账务系统。后续处置是先按同一类型把存量问题账单筛出来,批量订正账单上的支付对象,再推动产品侧优化比较逻辑。
本质
一句话:程序把“名称去掉标点后相等”当成了“同一家商户”,又在多个候选里默认取第一条,账单就挂到了另一家商户上,后面按合同比对的核对就过不去。
- 唯一性被交给了名称。合同里的支付对象本来有商户编号,编号才是唯一的;名称是给人看的,允许相似甚至重复。用名称决定选哪一家,等于把唯一性让给了一个不保证唯一的字段。
- 归一化把差异抹掉了。比较前去掉括号、空格这些符号,本意是容忍同一家商户的名称写法不同。可两家不同商户的名称如果只差这些符号,归一化之后就是同一个字符串,程序再分不出它们。
- 命中多条时取了第一条。按统一社会信用代码查回来的候选可能不止一条,程序只是顺序遍历,碰到第一条名称比中的就返回;既没有确认这次命中是否唯一,也没有回查这条记录是不是合同上写的那个支付对象。
- 错误对象一路带到核对。账单上写的是这家商户,核对拿它跟合同支付对象比,自然不一致;核对据此认定账单的收款商户信息不成立,整批拦下,不往账务系统推。生成环节没有报错,问题只在最后一步以“商户信息缺失”的形式出现,从提示上看不出是匹配错了对象。
名称去掉标点后相等,并不代表是同一家商户;命中多条还取第一条,等于把一次不确定性匹配当成了确定结果。
修复方向是:生成账单时按合同上的商户编号取支付对象,名称只用于展示和二次核对;只有编号确实取不到时才退化为名称匹配,并且要求候选唯一命中,0 条或多条都中止生成、转人工确认,而不是取第一条;核对环节固定用商户编号比对,名称写法差异不再决定账单能否推送。记录里给的处置是批量订正存量账单的支付对象,产品侧比较逻辑后续再优化,方案与上线状态待确认。
下面两段 Java 代码是按上述机制写的脱敏教学示例,只对比收款商户的选取方式,不代表实际项目源码或已上线实现。
错误代码
// 生成账单时确定收款商户(脱敏教学示例)
public class BillPayeeResolver {
private final MerchantClient merchantClient;
public Merchant resolve(String socialCreditCode, String contractPayeeName) {
List<Merchant> candidates = merchantClient.listBySocialCreditCode(socialCreditCode);
String expected = normalize(contractPayeeName); // 去掉括号、空格等符号
for (Merchant candidate : candidates) {
// 为什么错:归一化抹掉标点差异,两家不同商户的名称会变成同一个字符串
if (normalize(candidate.getName()).equals(expected)) {
// 为什么错:命中第一条就返回,既不确认命中是否唯一
// 也不回查它是不是合同上登记的那个支付对象
return candidate;
}
}
// 全部不比中时返回空;本例没有走这条分支,保留只为方法完整
return null;
}
}
修复代码示例
// 同一个入口:先按合同商户编号取,名称只在退化时使用且必须唯一(脱敏教学示例)
public class BillPayeeResolver {
private final MerchantClient merchantClient;
public Merchant resolve(String contractPayeeId, String socialCreditCode, String contractPayeeName) {
// 修复:收款方以合同上的商户编号为准,名称不参与选取
Merchant payee = merchantClient.getById(contractPayeeId);
if (payee != null && payee.isEffective()) {
return payee;
}
// 修复:编号取不到时才退化到名称匹配,且只接受唯一命中
List<Merchant> hits = merchantClient.listBySocialCreditCode(socialCreditCode).stream()
.filter(m -> m.isEffective())
.filter(m -> normalize(m.getName()).equals(normalize(contractPayeeName)))
.collect(Collectors.toList());
if (hits.size() == 1) {
return hits.get(0);
}
// 修复:0 条或多条都中止生成,转人工确认,不落不确定的收款商户
throw new PayeeUnresolvedException(contractPayeeId, hits.size());
}
}
下次遇到这些场景要警惕
- 用名称反查主体时:造两家名称只差括号、空格或全半角的数据跑一遍,看命中多条时程序是报错还是取第一条;取第一条就等于随机选一家。
- 账单落下收款商户后:拿“合同支付对象是甲、商户资料里还有名称近似的乙”的数据走完整生成与核对,确认账单上的商户编号等于合同上的编号,而不只是名称看着像。
- 核对报“商户信息缺失”时:先比账单上的商户编号与合同支付对象编号,再去看名称;不要一上来就按名称到商户资料里搜,否则容易把匹配错当成资料缺失。
- 批量订正账单前:按“账单收款商户编号与合同支付对象不一致”圈定范围,订正后重跑核对并确认推送结果;只改名称不改编号不算修好。