Jackson-databind中严格处理数字类型与字符串的转换问题

在基于OpenAPI规范开发API时，我们经常会遇到数字类型的处理问题。根据OpenAPI规范，type: number会被转换为java.math.BigDecimal类型。然而，Jackson库默认会将合法的数字字符串（如"12.50"）和纯数字（如12.50）都成功转换为BigDecimal，这可能导致与OpenAPI规范定义的类型约束产生偏差。

问题本质

问题的核心在于Jackson默认的数字类型转换行为过于宽松。虽然这种灵活性在某些场景下很有用，但在需要严格遵守OpenAPI规范的情况下，我们需要更严格的类型检查机制。

解决方案：使用CoercionConfig进行严格类型控制

Jackson提供了强大的类型强制配置（CoercionConfig）功能，可以精确控制不同类型之间的转换行为。对于需要严格限制数字类型转换的场景，我们可以这样配置：

ObjectMapper strictMapper = JsonMapper.builder()
    .withCoercionConfig(LogicalType.Float,
        cfg -> cfg.setCoercion(CoercionInputShape.String, CoercionAction.Fail))
    .build();

这段配置代码的含义是：

1. 针对所有浮点类型（LogicalType.Float，包括BigDecimal、float/Float、double/Double）
2. 当输入是JSON字符串时（CoercionInputShape.String）
3. 采取失败操作（CoercionAction.Fail）

实际应用效果

配置后，当JSON中包含字符串形式的数字值时，Jackson将抛出异常而不是自动转换。这确保了API严格遵循OpenAPI规范中定义的类型约束。

扩展知识：LogicalType分类

Jackson将Java类型分为几种逻辑类型（LogicalType），其中与数字相关的包括：

• Float：所有浮点类型
• Integer：所有整数类型
• Boolean：布尔类型
• String：字符串类型

通过理解这些逻辑类型分类，我们可以更灵活地控制各种类型之间的转换行为。

最佳实践建议

1. 在需要严格类型检查的API项目中，建议使用上述配置
2. 对于内部系统或需要灵活性的场景，可以保留默认配置
3. 考虑创建不同的ObjectMapper实例用于不同严格级别要求的场景
4. 在API文档中明确说明类型约束要求