一、价格校验的核心价值与业务场景

在电商、金融、物流等系统中，价格数据的准确性直接影响业务决策和用户体验。价格校验需覆盖数值范围、货币格式、精度控制、业务规则等多个维度。例如：

• 电商系统需确保商品价格≥0且符合促销规则
• 支付系统需校验金额精度（如人民币精确到分）
• 跨境业务需处理多币种格式转换
• 批发系统需验证阶梯定价的区间有效性

典型错误场景包括：负数价格导致系统漏洞、精度错误引发财务对账异常、格式不符造成支付失败等。有效的价格校验机制是保障业务稳定运行的基石。

二、Java原生校验方案解析

1. 基础数值校验

public class PriceValidator {
    public static boolean isValidPrice(BigDecimal price) {
        return price != null 
            && price.compareTo(BigDecimal.ZERO) >= 0 
            && price.scale() <= 2; // 限制小数位数
    }
}

此方法覆盖了空值检查、非负校验和精度控制，适用于大多数基础场景。

2. 正则表达式校验

public class CurrencyFormatValidator {
    private static final String PRICE_PATTERN = 
        "^\\d{1,12}(\\.\\d{1,2})?$"; // 最大12位整数，2位小数
    public static boolean validateFormat(String priceStr) {
        return priceStr != null && priceStr.matches(PRICE_PATTERN);
    }
}

正则方案适合字符串输入的初步校验，但需注意性能开销和国际化支持。

3. 组合校验策略

public class CompositePriceValidator {
    public static ValidationResult validate(BigDecimal price, 
                                          Currency currency,
                                          BigDecimal min,
                                          BigDecimal max) {
        ValidationResult result = new ValidationResult();
        if (price == null) {
            result.addError("价格不能为空");
        } else if (price.compareTo(min) < 0) {
            result.addError("价格不能低于" + min);
        } else if (price.compareTo(max) > 0) {
            result.addError("价格不能超过" + max);
        } else if (!isValidScale(price, currency)) {
            result.addError("价格精度不符合" + currency + "要求");
        }
        return result;
    }
    private static boolean isValidScale(BigDecimal price, Currency currency) {
        // 根据币种确定允许的小数位数
        int scale = currency.equals(Currency.getInstance("JPY")) ? 0 : 2;
        return price.scale() <= scale;
    }
}

组合校验将多个规则整合，提供更完整的验证逻辑。

三、Bean Validation标准实践

1. 基础注解应用

public class Product {
    @NotNull(message = "价格不能为空")
    @DecimalMin(value = "0.00", inclusive = true, message = "价格不能为负")
    @Digits(integer = 10, fraction = 2, message = "价格格式错误")
    private BigDecimal price;
    // getter/setter
}

通过JSR-380标准注解实现声明式校验，适合Spring等框架集成。

2. 自定义校验注解

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PriceRangeValidator.class)
public @interface ValidPrice {
    String message() default "价格超出允许范围";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    double min() default 0;
    double max() default Double.MAX_VALUE;
}
public class PriceRangeValidator implements ConstraintValidator<ValidPrice, BigDecimal> {
    private double min;
    private double max;
    @Override
    public void initialize(ValidPrice constraintAnnotation) {
        this.min = constraintAnnotation.min();
        this.max = constraintAnnotation.max();
    }
    @Override
    public boolean isValid(BigDecimal value, ConstraintValidatorContext context) {
        if (value == null) return true; // 允许单独使用@NotNull
        return value.compareTo(BigDecimal.valueOf(min)) >= 0 
            && value.compareTo(BigDecimal.valueOf(max)) <= 0;
    }
}

自定义注解提供更灵活的校验规则定义。

3. 分组校验策略

public interface ValidationGroups {
    interface Create {}
    interface Update {}
}
public class Product {
    @NotNull(groups = {Create.class, Update.class})
    @DecimalMin(value = "0.00", groups = {Create.class, Update.class})
    @ValidPrice(min = 1, max = 10000, groups = Create.class)
    private BigDecimal price;
}

分组校验实现不同业务场景下的差异化验证。

四、进阶校验场景处理

1. 多币种支持方案

public class MultiCurrencyValidator {
    private static final Map<Currency, Integer> CURRENCY_PRECISION = Map.of(
        Currency.getInstance("USD"), 2,
        Currency.getInstance("JPY"), 0,
        Currency.getInstance("BTC"), 8
    );
    public static boolean validatePrecision(BigDecimal amount, Currency currency) {
        Integer precision = CURRENCY_PRECISION.get(currency);
        return precision != null && amount.scale() <= precision;
    }
}

通过币种映射表管理不同货币的精度要求。

2. 动态规则引擎集成

public class RuleEngineValidator {
    public static ValidationResult validate(Product product, 
                                          List<ValidationRule> rules) {
        ValidationResult result = new ValidationResult();
        for (ValidationRule rule : rules) {
            if (!rule.getCondition().test(product)) continue;
            BigDecimal adjustedPrice = rule.getCalculator().apply(product.getPrice());
            if (adjustedPrice.compareTo(rule.getThreshold()) > 0) {
                result.addError(rule.getMessage());
            }
        }
        return result;
    }
}
// 使用示例
List<ValidationRule> rules = List.of(
    new ValidationRule(
        p -> p.getCategory().equals("ELECTRONICS"),
        price -> price.multiply(BigDecimal.valueOf(1.1)), // 电子类加价10%
        BigDecimal.valueOf(1000),
        "电子类商品加价后超过限额"
    )
);

规则引擎模式实现复杂业务逻辑的灵活配置。

3. 国际化错误处理

public class I18nPriceValidator {
    private final MessageSource messageSource;
    public I18nPriceValidator(MessageSource messageSource) {
        this.messageSource = messageSource;
    }
    public String validate(BigDecimal price, Locale locale) {
        if (price == null) {
            return messageSource.getMessage(
                "price.null", null, locale);
        }
        // 其他校验...
    }
}

结合Spring的MessageSource实现多语言错误提示。

五、最佳实践建议

1. 精度控制：始终使用BigDecimal处理货币计算，避免float/double的精度问题
2. 空值处理：明确区分”允许空”和”必须非空”的业务场景
3. 性能优化：对高频校验场景使用缓存机制存储规则
4. 测试覆盖：建立包含边界值、异常值的完整测试用例集
5. 日志记录：记录校验失败的详细信息便于问题排查
6. 文档规范：为每个校验规则编写清晰的业务说明文档

六、常见问题解决方案

Q1：如何处理不同国家的价格显示格式？
A：使用NumberFormat类进行本地化格式化

NumberFormat usFormat = NumberFormat.getCurrencyInstance(Locale.US);
String formatted = usFormat.format(new BigDecimal("1234.56"));
// 输出: $1,234.56

Q2：数据库存储与校验的精度差异如何处理？
A：在应用层统一使用BigDecimal，数据库字段采用DECIMAL(19,2)等精确类型

Q3：分布式系统中的价格校验如何保证一致性？
A：采用最终一致性模型，结合版本号控制和补偿机制处理并发修改

通过系统化的价格校验体系构建，开发者能够有效避免数据异常引发的业务风险，提升系统的可靠性和用户体验。建议根据实际业务需求选择合适的校验策略组合，并持续优化校验规则以适应业务发展。