BigDecimal.setScale后precision为0引发Avro序列化报错问题

首先明确两个核心结论：

• BigDecimal的精度延迟初始化设计不存在任何缺陷：构造实例时将precision设为0是JDK明确实现的懒加载优化策略，只有首次调用precision()方法时才会计算真实有效数字位数，该方法的返回值始终符合JavaDoc约定，不存在计算错误。
• Avro 1.10.0的Decimal校验逻辑没有问题：抛出异常的本质原因不是读取到了BigDecimal懒加载的0值，而是缩放后的数值真实精度确实超出了Schema定义的允许范围，异常抛出是符合Avro Decimal逻辑类型规范的正确行为。

你观察到的setScale()返回的BigDecimal实例precision=0只是懒加载的中间状态，和序列化失败没有因果关系：

1. 初始值16858.7109375执行setScale(5, RoundingMode.HALF_UP)后，得到的真实数值为16858.71094
2. 你配置的Avro Decimal类型参数为precision=9, scale=5，按照Decimal规范，该类型可存储的数值范围是-9999.99999到9999.99999——整数位最多允许4位（总精度9减去小数位5），小数位固定5位
3. 缩放后的数值16858.71094整数位有5位，总有效数字共10位，确实超出了Schema定义的精度上限，Avro调用value.precision()拿到的10是完全准确的真实精度值，因此触发异常。

你看到的源码中BigDecimal传0初始化precision的逻辑，只是为了减少不必要的精度计算开销，不会对外返回错误的精度值。

• 方案1（推荐）：调整Schema精度配置
  如果业务场景需要存储5位小数、万级及以上的整数数值，直接将Avro Schema中Decimal类型的precision配置为至少10（5位整数+5位小数），推荐预留冗余配置为12，适配更大范围的数值。配置示例：

{
  "type": "bytes",
  "logicalType": "decimal",
  "precision": 10,
  "scale": 5
}

• 方案2：前置数值范围校验（适用于Schema不可修改的场景）
  如果Schema是存量系统约定的固定配置不能修改，需要在序列化前增加数值归一化和范围校验逻辑，确保传入的数值在Decimal(9,5)的可存储范围内，避免序列化阶段抛出异常。示例代码：

private static final int TARGET_SCALE = 5;
private static final int MAX_PRECISION = 9;
// 计算Decimal(9,5)可存储的最大/最小值
private static final BigDecimal MAX_ALLOWED = BigDecimal.TEN.pow(MAX_PRECISION - TARGET_SCALE)
        .subtract(BigDecimal.valueOf(1, TARGET_SCALE));
private static final BigDecimal MIN_ALLOWED = MAX_ALLOWED.negate();

public BigDecimal normalizeDecimal(BigDecimal originVal) {
    // 先按要求缩放到指定小数位
    BigDecimal scaledVal = originVal.setScale(TARGET_SCALE, RoundingMode.HALF_UP);
    // 校验范围
    if (scaledVal.compareTo(MAX_ALLOWED) > 0 || scaledVal.compareTo(MIN_ALLOWED) < 0) {
        throw new IllegalArgumentException(String.format(
                "数值%s超出Decimal(%d,%d)允许的存储范围[%s, %s]",
                scaledVal, MAX_PRECISION, TARGET_SCALE, MIN_ALLOWED, MAX_ALLOWED
        ));
    }
    return scaledVal;
}

• 临时验证方案
  如果你需要确认BigDecimal的懒加载逻辑不影响精度计算结果，可以在setScale()之后主动调用一次v.precision()触发精度计算，此时可以看到实例内部的precision值会更新为10，和Avro校验时拿到的值一致，不存在计算偏差。注意该操作不会解决异常，仅用于验证逻辑。

内容的提问来源于stack exchange，提问作者Bartosz M.