@NumberFormat对BigDecimal失效，因其底层NumberFormat不支持直接转BigDecimal，且Spring未为BigDecimal注册对应Formatter；推荐用自定义StringToBigDecimalConverter、前端传标准数字字符串或@RequestBody配合@JsonFormat解决。
在 Spring Boot 中，@NumberFormat 不能直接用于 BigDecimal 类型的请求参数格式化（比如 @RequestParam 或 @ModelAttribute 字段），因为它底层依赖的是 Java 的 NumberFormat，而该类解析字符串时默认返回 Number（通常是 Double 或 Long），**不支持直接转成 BigDecimal**。
为什么 @NumberFormat 对 BigDecimal 失效？
@NumberFormat 是 Spring 提供的注解，主要用于将字符串按指定模式（如 pattern = "#,##0.00"）或区域（style = Style.CURRENCY）解析为数字类型。但 Spring 内置的 NumberFormatAnnotationFormatterFactory 在处理时：
- 对
Double、Float、Long、Integer等基本包装类型有默认 Formatter； - 对
BigDecimal—— 没有注册对应的 Formatter，所以即使你写了@NumberFormat(pattern = "0.00") private BigDecimal price;，Spring 仍会使用默认的字符串转BigDecimal逻辑（即调用new BigDecimal("123.45")），@NumberFormat注解被忽略。
正确接收并格式化 BigDecimal 参数的 3 种方式
✅ 推荐方式 1：用 @RequestParam + 自定义 Converter（最灵活、推荐）
创建一个全局的 Converter<string bigdecimal></string>，支持千分位、货币符号、任意小数位等解析：
立即学习“Java免费学习笔记（深入）”；
@Component
public class StringToBigDecimalConverter implements Converter<String, BigDecimal> {
private static final DecimalFormat df = new DecimalFormat("#,##0.00");
static {
df.setParseBigDecimal(true);
df.setGroupingUsed(true);
}
<pre class="brush:php;toolbar:false;">@Override
public BigDecimal convert(String source) {
if (source == null || source.trim().isEmpty()) {
return null;
}
try {
// 去掉货币符号、空格、常见非数字字符（保留 - . ,）
String cleaned = source.replaceAll("[^\d.,\-]", "").replaceAll("(?<=\D)\.(?=\D)", "");
// 若含逗号（如 "1,234.56"），用 Locale.US 解析
Number number = df.parse(cleaned);
return ((BigDecimal) number).setScale(2, RoundingMode.HALF_UP);
} catch (ParseException e) {
throw new IllegalArgumentException("Invalid number format: " + source, e);
}
}}
再注册到 WebMvcConfigurer：
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
registry.addConverter(new StringToBigDecimalConverter());
}
}之后 Controller 中可直接使用：
@GetMapping("/order")
public String getOrder(@RequestParam BigDecimal amount) { // ✅ 自动按 Converter 解析
System.out.println(amount); // 如传 "1,234.56" → 输出 1234.56
return "ok";
}✅ 方式 2：前端传标准格式（无逗号/符号），后端用 @DecimalMin/@DecimalMax 校验
最简单稳妥的做法：要求前端传纯数字字符串（如 "1234.56" 而非 "1,234.56" 或 "¥1,234.56"）。Spring 默认能正确构造 BigDecimal：
-
@RequestParam BigDecimal price→ 支持"123.45"、"-0.01"、"0" - 配合校验：
@DecimalMin("0.01") @DecimalMax("999999.99") BigDecimal price
✅ 优点：零配置、稳定、符合 REST 规范；⚠️ 缺点：需前后端约定格式。
✅ 方式 3：用 @JsonFormat 配合 @RequestBody（JSON 场景）
如果是 JSON 请求体（@RequestBody），@NumberFormat 依然无效，但可用 Jackson 的 @JsonFormat（需自定义序列化器）或更简单的方式：
- 前端传 JSON 数字字段：
{"price": 1234.56}→ 后端BigDecimal price自动接收（Jackson 默认支持） - 若必须传字符串（如
"price": "1,234.56"），则需自定义JsonDeserializer<bigdecimal></bigdecimal>并注册到 ObjectMapper
不推荐：强行用 @NumberFormat + BigDecimal（会静默失败）
以下写法无效，不要用：
public class OrderDTO {
@NumberFormat(pattern = "#,##0.00")
private BigDecimal amount; // ❌ 注解被忽略，仍走默认解析
}或
@GetMapping("/test")
public String test(@NumberFormat(pattern = "0.00") @RequestParam BigDecimal num) { // ❌ 不生效
return num.toString();
}原因：Spring 不识别该组合，运行时不会报错，但也不会按 pattern 解析。
真正需要格式化输入（如兼容 Excel 粘贴、财务系统导出数据），优先选自定义 Converter；若可控前端，建议统一用标准数字字符串传输。两者结合最稳。
