如何验证BigDecimal数值范围？@Digits与@DecimalMin/@DecimalMax问题求助

这个问题我之前也碰到过，踩过不少坑，咱们一步步拆解原因和解决方案：

问题原因分析 #

1. 为什么@Digits(integer=17, fraction=2)不通过1.10？ #

如果你的字段是BigDecimal类型，理论上1.10（小数位两位）完全符合fraction=2的要求，不应该验证失败。大概率是以下两种情况：

• 数据绑定丢失小数位：比如Spring MVC默认会把输入的字符串"1.10"转换成BigDecimal(1.1)（小数位一位），但即使这样，1.1的小数位数量也不超过2，依然符合@Digits的要求，所以这种情况不会导致失败。
• 旧版验证器bug：早期的Hibernate Validator（5.x之前）对BigDecimal的@Digits校验逻辑存在缺陷，可能误判末尾带零的小数。
• 如果你是要求小数部分必须恰好两位，那@Digits确实满足不了——它只限制小数位最多两位，不是必须两位。

2. 为什么@DecimalMin/@DecimalMax允许10.1234？ #

这是正常行为！@DecimalMin和@DecimalMax只负责校验数值的大小范围，完全不关心小数位数。只要10.1234落在0.00到99999999999999999.99之间，就会通过验证，这两个注解本来就不负责格式校验。

解决方案 #

方案1：正确组合@Digits与@DecimalMin/@DecimalMax（推荐） #

确保字段是BigDecimal类型，同时使用这三个注解，既校验格式位数，又校验数值范围：

import javax.validation.constraints.DecimalMax;
import javax.validation.constraints.DecimalMin;
import javax.validation.constraints.Digits;
import java.math.BigDecimal;

public class AmountForm {

    @Digits(integer = 17, fraction = 2, message = "整数部分最多17位，小数部分最多2位")
    @DecimalMin(value = "0.00", message = "数值不能小于0.00")
    @DecimalMax(value = "99999999999999999.99", message = "数值不能大于99999999999999999.99")
    private BigDecimal amount;

    // getter & setter
}

如果还是出现1.10验证失败的情况：

• 升级你的Hibernate Validator到6.x或更高版本，修复旧版的bug。
• 配置数据绑定保留小数位：比如在Spring MVC中添加@InitBinder强制格式化：

@InitBinder
public void initBinder(WebDataBinder binder) {
    DecimalFormat df = new DecimalFormat("#.##");
    df.setParseBigDecimal(true);
    binder.registerCustomEditor(BigDecimal.class, new CustomNumberEditor(BigDecimal.class, df, true));
}

方案2：自定义验证逻辑（严格控制小数位） #

如果要求小数部分必须是0或2位（比如金额场景），可以用@AssertTrue实现自定义校验：

import javax.validation.constraints.AssertTrue;
import javax.validation.constraints.DecimalMax;
import javax.validation.constraints.DecimalMin;
import java.math.BigDecimal;

public class AmountForm {

    @DecimalMin(value = "0.00", message = "数值不能小于0.00")
    @DecimalMax(value = "99999999999999999.99", message = "数值不能大于99999999999999999.99")
    private BigDecimal amount;

    @AssertTrue(message = "整数部分最多17位，小数部分最多2位")
    public boolean isAmountFormatValid() {
        if (amount == null) {
            return true; // 允许为空则返回true，否则返回false
        }
        // 计算整数部分位数：总精度 - 小数位
        int integerDigits = amount.precision() - amount.scale();
        return integerDigits <= 17 && amount.scale() <= 2;
    }

    // getter & setter
}

方案3：正则表达式（字段为String类型时） #

如果字段必须是String类型（不推荐金额用String），可以用@Pattern控制格式，再配合范围校验：

import javax.validation.constraints.DecimalMax;
import javax.validation.constraints.DecimalMin;
import javax.validation.constraints.Pattern;

public class AmountForm {

    @Pattern(regexp = "^(0|([1-9]\\d{0,16}))(\\.\\d{1,2})?$", message = "整数部分最多17位，小数部分最多2位")
    @DecimalMin(value = "0.00", message = "数值不能小于0.00")
    @DecimalMax(value = "99999999999999999.99", message = "数值不能大于99999999999999999.99")
    private String amount;

    // getter & setter
}

内容的提问来源于stack exchange，提问作者Amir