一、SpringBoot默认序列化机制解析

SpringBoot框架通过spring-boot-starter-json依赖自动配置了Jackson库作为默认JSON处理器，其核心组件包含：

ObjectMapper：序列化/反序列化的核心引擎
JsonSerializer：类型特定的序列化策略接口
AnnotationIntrospector：注解处理中枢

默认配置下，当处理以下数据结构时会产生不符合前端预期的输出：

public class SampleData {
    private String name;       // 未赋值时输出null
    private Integer age;       // 未赋值时输出null
    private LocalDate birth;   // 未赋值时输出null
}

前端期望的标准化响应格式应为：

{
    "name": "",
    "age": 0,
    "birth": "1970-01-01"
}

二、序列化定制的三种实现方案

方案1：全局ObjectMapper配置（推荐）

通过自定义Jackson2ObjectMapperBuilderCustomizer实现全局配置：

@Configuration
public class JsonConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        converters.add(new MappingJackson2HttpMessageConverter(customObjectMapper()));
    }
    private ObjectMapper customObjectMapper() {
        return new Jackson2ObjectMapperBuilder()
            .serializers(new CustomStringSerializer())
            .serializers(new CustomNumberSerializer())
            .dateFormat(new SimpleDateFormat("yyyy-MM-dd"))
            .defaultViewInclusion(true)
            .build();
    }
}

方案2：字段级注解控制

通过@JsonSerialize实现细粒度控制：

public class User {
    @JsonSerialize(using = EmptyStringSerializer.class)
    private String nickname;
    @JsonSerialize(using = ZeroNumberSerializer.class)
    private Integer loginCount;
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createTime;
}

方案3：混合模式（推荐实践）

结合全局配置与局部覆盖：

@Configuration
public class JsonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 全局配置
        mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
        mapper.registerModule(new SimpleModule()
            .addSerializer(String.class, new EmptyStringSerializer())
            .addSerializer(Number.class, new ZeroNumberSerializer())
        );
        // 日期全局配置
        mapper.setDateFormat(new StdDateFormat().withColonInTimeZone(true));
        return mapper;
    }
}

三、核心序列化器实现详解

空字符串序列化器

public class EmptyStringSerializer extends JsonSerializer<String> {
    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider provider) 
        throws IOException {
        gen.writeString(value == null ? "" : value);
    }
}

数字零序列化器

public class ZeroNumberSerializer extends JsonSerializer<Number> {
    @Override
    public void serialize(Number value, JsonGenerator gen, SerializerProvider provider) 
        throws IOException {
        gen.writeNumber(value == null ? 0 : value.intValue());
    }
}

日期标准化序列化器

public class CustomDateSerializer extends JsonSerializer<LocalDate> {
    private static final DateTimeFormatter FORMATTER = 
        DateTimeFormatter.ofPattern("yyyy-MM-dd");
    @Override
    public void serialize(LocalDate value, JsonGenerator gen, SerializerProvider provider) 
        throws IOException {
        gen.writeString(value == null ? "1970-01-01" : value.format(FORMATTER));
    }
}

四、性能优化与异常处理

序列化性能优化

缓存机制：对频繁使用的格式化器进行静态化
异步处理：结合响应式编程实现非阻塞序列化
批量操作：使用JsonGenerator的批量写入方法

异常处理策略

public class SafeNumberSerializer extends JsonSerializer<Number> {
    @Override
    public void serialize(Number value, JsonGenerator gen, SerializerProvider provider) 
        throws IOException {
        try {
            gen.writeNumber(value == null ? 0 : value.doubleValue());
        } catch (Exception e) {
            gen.writeNumber(0);
            provider.defaultSerializeNull(gen);
        }
    }
}

五、高级应用场景

1. 多视图支持

public class User {
    public interface BasicView {}
    public interface DetailView extends BasicView {}
    @JsonView(BasicView.class)
    private String username;
    @JsonView(DetailView.class)
    private String password;
}
// 控制器使用
@JsonView(User.DetailView.class)
@GetMapping("/detail")
public User getDetail() { ... }

2. 动态字段过滤

@Configuration
public class JsonConfig {
    @Bean
    public FilterProvider filterProvider() {
        SimpleFilterProvider provider = new SimpleFilterProvider();
        provider.addFilter("userFilter", 
            SimpleBeanPropertyFilter.filterOutAllExcept("id", "username"));
        return provider;
    }
}

3. 自定义命名策略

@Configuration
public class JsonConfig {
    @Bean
    public PropertyNamingStrategies.NamingBase namingStrategy() {
        return new PropertyNamingStrategies.SnakeCaseStrategy();
    }
}

六、测试验证方案

单元测试示例

@Test
public void testCustomSerialization() throws JsonProcessingException {
    ObjectMapper mapper = new ObjectMapper();
    mapper.registerModule(new SimpleModule()
        .addSerializer(String.class, new EmptyStringSerializer())
        .addSerializer(Number.class, new ZeroNumberSerializer())
    );
    SampleData data = new SampleData();
    String result = mapper.writeValueAsString(data);
    assertEquals("{\"name\":\"\",\"age\":0}", result);
}

集成测试建议

使用SpringBoot Test的MockMvc进行端到端测试
验证不同Content-Type下的序列化行为
测试异常场景下的降级处理

七、生产环境部署要点

配置管理：将序列化配置外化为配置文件
版本兼容：确保Jackson版本与SpringBoot版本兼容
监控告警：对序列化错误进行监控
A/B测试：新旧序列化方案并行运行验证

通过系统化的序列化定制，开发者可以构建出既符合业务规范又具备高性能的API接口。建议根据项目实际需求选择合适的实现方案，对于大型项目推荐采用方案3的混合模式，在保证灵活性的同时维护代码一致性。在云原生环境下，序列化配置应纳入基础设施即代码（IaC）管理体系，确保多环境部署的一致性。

SpringBoot中JSON序列化的深度定制与最佳实践