JAVA之数据配置错误引发0E-8异常

目录

1、问题描述

2、原因分析

3、案例总结

---

运行环境：

• Windows-7-Ultimate-x64、CentOS-7.9.2009-x64
• OracleJDK-1.8_u201
• IntelliJ IDEA Community Edition 2022.2.2
• Maven-3.6.3

1、问题描述

       用户下单支付成功后，计算的 代理商佣金金额 大于0时，自动触发 分佣逻辑（注：由MQ异步事务处理）。功能开发完成后，在DEV和SIT环境进行过N轮测试，计算的值未发生过异常。但发布到 UAT环境 后，却出现计算结果为 0E-8，最终致使分佣失败。

公式：

代理商佣金金额 = (商品销售总金额 * (1 - 支付通道使用费率) - 商品签约总金额) * 代理商佣金比例

2、原因分析

公式很简单，分解后的因子如下：

• 商品销售价格：新增商品 时必填，且至少为 0.01 元
• 商品签约价格：新增商品 时必填，且至少为 0.01 元
• 支付通道使用费率：统一默认 千分之六，即 0.006
• 代理商佣金比例：由运营专员配置，新账号默认为 0.000（可选值 0.000~0.300，即0.0%至30.0%）

        根据以上可得知，最有可能引起计算数据异常的是 代理商佣金比例 配置出错 或 未配置。经过核对相关日志、配置数据，证实了猜测。

以下为模拟代码：

/** 主函数 */
public static void main(String[] args) {
    BigDecimal orderAmount = new BigDecimal("99.90");              // 商品销售总金额
    BigDecimal paymentCommissionRate = new BigDecimal("0.006");    // 支付通道使用费率
    BigDecimal agreementAmount = new BigDecimal("70.05");          // 商品签约总金额
    BigDecimal rewardPercent = new BigDecimal("0.000");            // 代理商佣金比例

    // 代理商实收金额 = (商品销售总金额 * (1 — 支付通道使用费费率) — 商品签约总金额) * 代理商佣金比例
    BigDecimal orderRewardAmount = orderAmount.multiply(BigDecimal.ONE.subtract(paymentCommissionRate)).subtract(agreementAmount).multiply(rewardPercent);
    
    // 默认打印：0E-8
    System.out.println(orderRewardAmount);
    // 格式化打印：0.00000000
    System.out.println(orderRewardAmount.toPlainString());
    
    // BigDecimal.ZERO 与 0E-8 比较大小：true
    System.out.println(BigDecimal.ZERO.compareTo(orderRewardAmount) == 0);
}

输出结果：

3、案例总结

        由于代码刚部署到新环境，业务人员 可能着急体验新功能，在新建 代理商测试账号 后，忘记调整 账户佣金比例 配置，导致程序根据计算公式得到的数据值异常。所以，熟悉业务流程细节也很重要噢……

        写这篇文章的初衷，是做开发这么多年，第一次在JAVA中遇到以科学计数法形式的数据，特将此场景分析整理记录。

• 0E-8  ：0.00000000  即 整数位为 0，小数位为 8个 0
• 0E-12：0.000000000000  即 整数位为 0，小数位为 12个 0