发生了什么
商户把票开好之后,要在商户端上传发票:选好发票文件提交,系统调用第三方的发票识别服务,把票面上的信息读出来,包括发票号码、金额和税目。税目是这张发票上的货物或服务属于哪一类应税项目,平台对上传的发票有票面要求,读出来的税目和约定的开票内容对不上,就会提示税目错误,这张票不能通过上传。
正常流程分三步:商户提交文件,系统识别票面,再拿识别结果做校验;三步都通过,系统才为这张发票留一条记录,商户在列表里看到它已经上传。中间任何一步不通过,这次上传都应当作废,系统里不留这张票。
这次第一张发票就卡在税目上:第三方识别服务读出来的税目和票面不一致,校验按这个错误的税目判了不通过。商户按提示换了一张税目正确的发票重新上传,报的还是同一句税目错误;之后再换文件、再传,结果都一样。最后是把这张发票删掉、重新上传,才通过。
本质
第三方识别偶尔读错票面,这是外部服务的能力边界,系统无法保证它每次都准。问题出在系统拿到一个错误结果之后怎么处理。
- 上传入口先按识别结果组装出一条发票记录并写进存储,然后才对税目做校验。校验的结论是不通过,程序抛出提示返回,但刚写进去的那条记录既没有删除,也没有标记作废。
- 从这一刻起,这笔业务在系统里已经有一张发票了。商户重新上传时,程序按商户和业务找到这条已有记录,校验用的是记录里保存的税目,而不是这次新传文件识别出来的税目,新的票面根本没有参与判断。
- 于是第二张票内容再正确也没用:比的还是第一次识别错的那个税目,报出来的自然是同一句错误。用户看到的是“换成正确的发票还报错”,实际被判断的始终是那条旧记录。
- 删掉这张发票之所以能恢复,是因为删除同时去掉了两个前提:这笔业务已经有发票,以及那条错误的税目。再上传时系统只能重新识别,识别正确就通过了。
- 已经提的优化是识别或校验不通过时不保存发票信息,方向是对的:第三方识别不可能永远正确,系统能做的是别让一次错误识别变成长期阻断。这条优化是否上线没有记录,处置上仍写着优化前需要研发手动删掉这条记录。
校验没通过,识别结果却已经存了下来;之后每一次正确的上传,都在和这条错误记录比。
修复方向是:校验放在写入之前,通过了才落库;失败路径上不留下任何记录;重传时如果发现已有未通过的记录,要重新识别或允许覆盖,而不是拿旧记录的字段做判断。
以下两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
public class InvoiceUploadService {
public void upload(Long merchantId, String bizNo, MultipartFile file) {
InvoiceRecord exist = invoiceMapper.selectByBiz(merchantId, bizNo);
if (exist != null) {
// 为什么错:命中旧记录就按它存的税目校验,这次传的票面不再被识别
checkTaxItem(merchantId, exist.getItemName());
return;
}
// 为什么错:识别结果先落库,这一步的写入已经提交,后面的校验管不到它
InvoiceRecord record = buildRecord(merchantId, bizNo, ocrClient.recognize(file));
invoiceMapper.insert(record);
// 为什么错:校验抛错只把提示返回给页面,上面那条记录留在库里
checkTaxItem(merchantId, record.getItemName());
}
private void checkTaxItem(Long merchantId, String itemName) {
if (!taxItemRule.matches(merchantId, itemName)) {
throw new BizException("发票税目错误,请重新上传");
}
}
}
修复代码示例
public class InvoiceUploadService {
public void upload(Long merchantId, String bizNo, MultipartFile file) {
InvoiceRecord exist = invoiceMapper.selectByBiz(merchantId, bizNo);
// 修复:没通过校验的旧记录是失败留下的残留,先清掉,让本次重新识别
if (exist != null && !exist.passed()) {
invoiceMapper.deleteById(exist.getId());
} else if (exist != null) {
throw new BizException("该笔业务已有通过校验的发票,不能重复上传");
}
OcrResult ocr = ocrClient.recognize(file);
// 修复:识别结果先校验,通过了才组装记录并写入
checkTaxItem(merchantId, ocr.getItemName());
invoiceMapper.insert(buildRecord(merchantId, bizNo, ocr));
}
private void checkTaxItem(Long merchantId, String itemName) {
if (!taxItemRule.matches(merchantId, itemName)) {
// 抛出时不产生任何写入,重复上传仍会重新识别
throw new BizException("发票税目错误,请重新上传");
}
}
}
下次遇到这些场景要警惕
- 上传、导入这类入口接外部识别或第三方返回时,专门造一次“返回内容不正确”的输入,比如换一张票面税目写错的发票;提交后看系统里是否多了一条记录,再用内容正确的文件传一次,确认能通过。
- 检查校验的取值来源:同一笔业务已有记录时,程序是重新解析本次输入,还是直接读库里的旧字段。两种写法在正常路径下表现一致,只有在旧记录本身是失败留下的脏数据时才会分叉。
- 报错文案只提票面原因(税目错误、抬头不一致)时,不要默认是票面真错;同一条错误在不同文件、不同时间反复出现,先查持久化里有没有失败留下的残留。
- 如果人工处置只有“把记录删掉再重来”,要把它当成缺陷信号:说明失败路径缺少清理,这个动作迟早会落到值班同学手上,而线上不一定有人知道该删哪条。