发生了什么
发票上传这一步,是把开好的发票交给系统:系统会拿 OCR 识别出的票面信息,与第三方验真接口返回的结果核对,确认这张票是不是真的。两边都有销售方名称、购买方名称,系统会把它们各比一遍,一致才允许这张发票上传成功。
比名称这一步不能只做逐字相等。销售方、购买方的名称里本来就可能带括号,票面打印出来可能是全角括号,验真接口返回的可能是半角括号,肉眼看是同一个名字,字符串却不相等。为此 11 月专门加过一条规则:比较前把括号这类符号忽略掉,只看文字部分。
这次是 12 月 18 日的一版发票优化上线后,这条规则没有跟上来。带括号的发票传上来,OCR 识别和验真结果只差括号写法,系统判成“发票抬头不一致”,上传被拦在入口。受影响的是销售方或购买方名称带括号的发票,具体张数、涉及多少上传人没有统计。
发现问题后先判断是代码问题,第一步是止血:打开回滚开关把上传入口切回老逻辑,23 点完成回滚。当晚 20 点还上线过一版修复,21 点核对时发现 20 点之后没有发票上传成功,22 点半确认问题还是当天上线的代码引起的。回滚之后是否所有发票都恢复、这次修复最终是否验证通过,现有信息没有说明。
本质
直接原因是:新写的名称比对方法里没有那段忽略符号的处理,而它在这次上线后接替了老方法的位置。
- 11 月的修复把“忽略括号符号再比”写在老方法里,只此一份。老方法一直被上传链路调用,所以 11 月之后带括号的发票本来能通过。
- 这次发票优化要调整比对,开发在自己的本地仓库里把老方法整体复制成新方法,在副本上改。本地仓库很久没有同步,复制到的是 11 月改动之前的版本,归一化那几行没有跟过来。
- 上传链路改为调用新方法,老方法不再被走到。新方法只去掉首尾空格就逐字比较,全角括号与半角括号的差异原样留着,同一个名称的两种括号写法因此被判成两个不同的名称。
- 上传时销售方、购买方各比一次,任意一边不等就抛“发票抬头不一致”,整张发票被拒绝;报错只写抬头不一致,从提示上看不出只是括号写法不同。
- 因为这次是新增方法而不是改原方法,把改动合到发布分支时没有冲突提示;开发和测试都不知道这个字段历史上有一条忽略括号的规则,用例里也没有带括号的名称,缺陷就跟着版本一起上线了。
把老方法复制成新方法时,老方法里“看起来多余”的归一化不会自动跟过来;新方法一旦接替老入口,等于把之前的修复整段回退。
修复方向是:把名称归一化收到一处,销售方、购买方、新旧两个比对方法都调用同一份逻辑,比较前把全角括号、半角括号、空白和常见标点去掉,新方法不再自己复制一份比较规则。下面 Java 代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;后续 hotfix 的上线与验证状态待确认。
错误代码
// 发票上传:名称比对的老方法被复制成新方法后接到链路上(脱敏教学示例)
public class InvoiceNameChecker {
// 12 月改版新增:从老方法复制出来,在副本上调整
public boolean compareV2(String ocrName, String verifyName) {
if (ocrName == null || verifyName == null) {
return false;
}
// 为什么错:只去掉首尾空格,11 月加的“忽略符号”归一化没有跟过来
String left = ocrName.trim();
String right = verifyName.trim();
// 为什么错:全角、半角括号的差别原样留在字符串里,逐字比较必然不等
return left.equals(right);
}
public void upload(Invoice invoice) {
VerifyResult result = verifyClient.verify(invoice);
boolean buyerOk = compareV2(invoice.getBuyerName(), result.getBuyerName());
boolean sellerOk = compareV2(invoice.getSellerName(), result.getSellerName());
if (!buyerOk || !sellerOk) {
// 为什么错:只是括号写法不同也走到这里,正常发票被判成抬头不一致
throw new BizException("发票抬头不一致");
}
invoiceRepository.saveVerified(invoice);
}
}
修复代码示例
// 修复:名称归一化只留一份,新旧比对方法都调它(脱敏教学示例)
public final class InvoiceNames {
private static final Pattern SYMBOLS = Pattern.compile("[\\s()()【】\\[\\]·.,,、\\-]");
static String normalize(String name) {
if (name == null) {
return "";
}
// 修复:先折叠全角、半角写法,再去掉括号、空白和标点,只留文字
String folded = Normalizer.normalize(name, Normalizer.Form.NFKC);
return SYMBOLS.matcher(folded).replaceAll("");
}
static boolean sameName(String left, String right) {
// 修复:两边都归一化之后再比,括号写法不同不再算不一致
return normalize(left).equals(normalize(right));
}
}
public class InvoiceNameChecker {
public boolean compareV2(String ocrName, String verifyName) {
// 修复:不再各自 trim 后 equals,统一走同一个归一化
return InvoiceNames.sameName(ocrName, verifyName);
}
}
下次遇到这些场景要警惕
- 从老方法复制一个新方法来改时,先把老方法近几个月的修改记录拉出来,逐条确认哪些逻辑必须带过去;复制完用同一组输入分别跑老方法和新方法,结论不一致就先停下来。
- 名称、地址、证件号这类来自两个来源的文本要比对时,构造全角括号、半角括号、全角空格、多余标点各一条数据,完整走一次上传,确认它们被判成同一个名称,而不是各自被拒。
- 改共用校验入口时按入口反查调用方:新方法一旦被接到线上链路,老方法里的历史修补就失效了,要确认针对历史缺陷的用例跟着迁移到新入口。
- 用开关回滚止血后,不要只看开关有没有打开,要按小时核对回滚后成功上传的数量,确认业务真的恢复;被判断为“改动小、开发自测”的发布,也要补跑该字段历史缺陷的用例。