发生了什么

平台向商户租场地,按月付租金和电费。系统每个月生成一个应付款批次,批次上按费用类型分栏,记这一期「还应开多少票」:租金一栏、电费一栏,每栏都带着商户在后台按该费用类型维护的约定税率。

商户开好发票上传,系统先做票面识别和税务验真,再把识别结果给商户确认;商户点确认后,系统按发票明细里的货物名称判断这张票属于租金还是电费,找到对应那一栏,用该栏的约定税率校验票面税率,一致才扣减该栏余额、完成核销。

正常情况是:电费发票进电费栏,按电费栏 13% 的约定税率校验,票面也是 13%,扣减余额,核销完成。商户端只看得到识别结果和确认按钮,判断归类和校验都在后台完成。

这次不一样。2026 年 1 月签的框架协议约定电费税率 13%,但 1 月到 6 月商户上传的电费发票,票面税率都是 6%。每一次系统都识别通过、核销完成,商户端没有任何异常提示。事后核对代码发现:取栏位的逻辑在一次改动后改成「找不到就返回余额最大的那一栏」,归不到电费栏时不报错,直接扣在另一类费用的栏上,再用那栏的税率完成校验。差额是 7 个百分点的进项抵扣;这部分按经营成本列支,业务上不认定为资损,也没有金额层面的认定。同类风险有明确前提,只有租金与电费两侧配置的税率不同的商户才可能发生;两侧税率相同时,扣到哪一栏都不产生税率差。

本质

一句话:取栏位的方法被改成了「找不到就返回余额最大的那一栏」,原来「归不到对应栏就报错阻断」的判断再也不会成立,发票被扣到另一种费用的栏上,又拿那一栏的税率去校验,低税率发票就这样被放行。

  1. 先归类。系统用发票明细的货物名称映射出目标费用类型,租金或电费,再按这个类型去批次明细里取栏位。改动前取不到就返回空,调用点拿到空就抛「票据类型校验不通过」。
  2. 一次提交换掉了取数方式。新方法在遍历明细没有命中时,直接返回列表的最后一项,永不返回空。明细按可抵扣余额升序排,最后一项正好是余额最大的那一栏。
  3. 空值判断变成死代码。调用点原来的「取到空就阻断」还在,但已经不可能执行。归不到对应栏,程序不报错,继续往下扣,扣的是余额最大的那一栏。
  4. 扣减之后的负数检查也失效。扣的本来就是余额最大的一栏,扣完通常还剩正数,「有没有栏位被扣成负数」这个检查什么也发现不了,数据直接落库。
  5. 结果是这张票的税率和被扣栏位的约定税率对不上。校验按被扣栏位的税率做,6% 的票面落在 13% 的口径上,差额留在账上,商户侧看不到任何异常。

触发条件有两个,都指向「目标栏拿不到」:映射出的费用类型在明细里没有对应栏;或者那一栏的余额已经扣光,遍历时被跳过,余额恰好为零的栏在汇总阶段就已被过滤掉。两条路径进入的是同一个兜底返回值,因此表现完全一样。

兜底返回值把「找不到对应栏」伪装成「找到了一栏」,后面所有依赖「取不到就报错」的校验一起失效,本来该被拦下的归类错误变成了静默通过。

修复方向是:抵扣时按具体费用类型取栏并校验,取不到就阻断,让商户确认税目后重新上传,不再用兜底栏位承接;同时必须用该费用类型自己的税率配置校验票面税率。短期上,这个商户 6 月起的最新合同已把租金与电费税率统一为 6%,不会再出现同样的差额;长期修复已按上述方向排期,是否已上线并验证,记录里没有结论。

错误代码

public void confirmInvoice(InvoiceConfirmRequest request, List<BatchSummary> batchSummaries) {
    // 明细按可抵扣余额升序,末位是余额最大的一栏
    List<BatchSummary> sorted = batchSummaries.stream()
            .sorted(Comparator.comparing(BatchSummary::getDeductibleBalance))
            .collect(Collectors.toList());
    FeeType feeType = resolveFeeType(request.getGoodsName());   // 租金 / 电费
    BatchSummary target = getBatchSummaryModel(sorted, feeType);
    if (target == null) {
        // 为什么错:兜底方法永不返回 null,这个阻断分支成了死代码
        throw new BizException("INVOICE_FEE_TYPE_NOT_MATCH");
    }
    target.setDeductibleBalance(target.getDeductibleBalance().subtract(request.getAmount()));
    if (anyMatchNegativeAmount(sorted)) {
        // 为什么错:扣在余额最大的栏,扣完通常仍为正,查不出扣错了栏
        throw new BizException("INVOICE_BALANCE_NEGATIVE");
    }
    markConfirmed(request.getInvoiceId(), target);   // 为什么错:落库记的是另一类费用的栏
}
private BatchSummary getBatchSummaryModel(List<BatchSummary> sorted, FeeType feeType) {
    for (BatchSummary summary : sorted) {
        if (summary.getFeeType() == feeType) {
            return summary;
        }
    }
    // 为什么错:归不到对应栏时兜底取余额最大栏,把「没找到」变成「找到一栏」
    return sorted.get(sorted.size() - 1);
}

修复代码示例

public void confirmInvoice(InvoiceConfirmRequest request, List<BatchSummary> batchSummaries) {
    FeeType feeType = resolveFeeType(request.getGoodsName());   // 租金 / 电费
    BatchSummary target = findBatchSummary(batchSummaries, feeType);
    if (target == null) {
        // 取不到对应栏就阻断:提示商户确认税目后重新上传,不再串扣别的栏
        throw new BizException("INVOICE_FEE_TYPE_NOT_MATCH");
    }
    // 只拿这个费用类型自己的税率配置校验,串栏时在这里就被拦住
    if (!target.getAgreedTaxRate().equals(request.getInvoiceTaxRate())) {
        throw new BizException("INVOICE_TAX_RATE_NOT_MATCH");
    }
    BigDecimal after = target.getDeductibleBalance().subtract(request.getAmount());
    if (after.signum() < 0) {
        throw new BizException("INVOICE_BALANCE_NEGATIVE");
    }
    target.setDeductibleBalance(after);
    markConfirmed(request.getInvoiceId(), target);
}
private BatchSummary findBatchSummary(List<BatchSummary> batchSummaries, FeeType feeType) {
    // 找不到就是找不到,返回空交给调用方阻断,不做兜底
    return batchSummaries.stream()
            .filter(summary -> summary.getFeeType() == feeType)
            .findFirst()
            .orElse(null);
}

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。修复版把「取不到对应栏」和「票面税率与该栏配置不一致」拆成两次显式校验,比原来只依赖扣减后不许为负更早拦住问题;余额不足仍然单独报错,不把三件事合成一个分支,也不靠事后清数据补救。

下次遇到这些场景要警惕

  • 给取值方法加兜底返回值时:先搜出所有调用点,逐个看有没有「取到空就阻断」的分支;用「目标不存在」的数据跑一遍,观察阻断还在不在。兜底值和正常值长得一样,代码评审时最容易被当成优化放过。
  • 改造按类型分栏扣减的逻辑时:至少构造两组数据,一组是目标栏不存在,一组是目标栏余额为 0 或已扣光;观察扣减落在哪一栏,再确认落库记录的费用类型和税率是否与票面一致。
  • 做「按类目配置校验」的功能时:确认校验取的是与业务对象同一类目的配置值,而不是最近的一栏或余额最大的一栏;把两类配置故意设成不同税率(例如 13% 与 6%),再提交低税率发票,确认被拦住。
  • 有「扣完不许为负」这类事后检查时:别把它当成归类正确的证据;用余额充足的栏位构造一次串扣,看检查是否毫无反应,从而反推校验层级是不是放错了位置。