在 spring boot 中校验金额格式,最稳妥的做法是使用 @decimalmin、@decimalmax 和 @digits 注解组合,或者使用自定义的 pattern 正则表达式。前者适用于需要限制数值范围和小数位数的场景,后者适用于严格匹配特定字符串格式(如两位小数)的场景。

@DecimalMin 与 @Digits 如何配合使用
这两个注解通常一起使用来确保金额既在合法范围内,又符合精度要求。@DecimalMin 用于设定下限,@Digits 用于控制整数位和小数位的长度。这种组合能直接拦截非法的数值类型输入。

import javax.validation.constraints.DecimalMin;
import javax.validation.constraints.Digits;
public class OrderRequest {
@DecimalMin(value = "0.01", message = "金额必须大于0")
@Digits(integer = 10, fraction = 2, message = "金额格式错误")
private Double amount;
}
上述代码中,amount 字段被限制了最大整数位为 10 位,小数位最多 2 位,且最小值为 0.01。如果传入 12345678901.23,会因为超过整数位限制而报错;如果传入 -5.00,则因为小于最小值而报错。
使用 @Pattern 进行严格的字符串格式校验
当金额以字符串形式传输,且需要严格保证小数点后只有两位时,@Pattern 是更好的选择。它通过正则表达式直接匹配字符串结构,避免了浮点数精度问题。

import javax.validation.constraints.Pattern;
public class PaymentRequest {
@Pattern(regexp = "^\d+(\.\d{1,2})?$", message = "金额格式不正确")
private String price;
}
该正则表达式 ^d+(.d{1,2})?$ 确保了输入由数字组成,可选的小数部分最多包含两位。例如,100 和 100.5 都是合法的,但 100.123 或 abc 会被拒绝。这种方式在处理前端传来的 JSON 字符串时非常有效。
处理空值和默认行为的具体问题
在使用上述注解时,一个常见的具体问题是:如果请求体中完全省略了金额字段,或者将其设为 null,校验器会如何处理?默认情况下,@DecimalMin 和 @Pattern 不会校验 null 值,即它们允许为空。如果需要强制必填,必须额外添加 @NotNull 注解。此外,对于 @Digits,如果传入的是 0,它是合法的,因为它满足整数位和小数位的要求,但不满足 @DecimalMin("0.01") 的条件,因此会被拦截。开发者需要根据业务逻辑决定是否需要同时使用 @NotNull 和范围限制。











