如何在Spring Boot Rest响应中将布尔值序列化为字符串？

我刚好之前处理过类似的Jersey到Spring Boot迁移的兼容问题，这种布尔值序列化格式不兼容的情况确实挺头疼的，尤其是旧系统没法修改的情况下。先明确说：没有直接对应的spring.jackson.serialization配置属性可以一键把所有布尔字段序列化为带引号的字符串，但我们可以通过自定义Jackson序列化器来实现全局或局部的兼容，下面是具体方案：

方法一：全局生效（所有布尔字段统一转字符串格式） #

如果希望整个应用的布尔字段都保持和Jersey一致的序列化格式，推荐用这种方式：

1. 自定义布尔值序列化器

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.SerializerProvider;
import java.io.IOException;

public class BooleanToStringSerializer extends JsonSerializer<Boolean> {
    @Override
    public void serialize(Boolean value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        // 把布尔值转成带引号的字符串，null场景可根据旧应用逻辑调整，比如返回"null"或直接输出null
        if (value == null) {
            gen.writeString("null");
        } else {
            gen.writeString(value.toString());
        }
    }
}

2. 在Spring Boot中注册序列化器
   创建配置类，将自定义序列化器绑定到布尔类型（包括包装类和基本类型）：

import com.fasterxml.jackson.databind.module.SimpleModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.Jackson2ObjectMapperBuilder;

@Configuration
public class JacksonConfig {
    @Bean
    public Jackson2ObjectMapperBuilder jackson2ObjectMapperBuilder() {
        Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder();
        SimpleModule module = new SimpleModule();
        // 注册序列化器到Boolean包装类
        module.addSerializer(Boolean.class, new BooleanToStringSerializer());
        // 同时处理boolean基本类型
        module.addSerializer(boolean.class, new BooleanToStringSerializer());
        builder.modules(module);
        return builder;
    }
}

配置完成后，所有布尔类型字段都会被序列化为带引号的字符串，比如success: "true"。

方法二：局部生效（仅特定字段转字符串格式） #

如果只有部分字段需要保持旧格式，不需要全局修改，直接在目标字段上添加注解即可：

public class ApiResponse {
    // 该字段会被序列化为"true"/"false"格式
    @JsonSerialize(using = BooleanToStringSerializer.class)
    private Boolean success;

    // 其他字段保持Spring默认的布尔值序列化格式
    private Integer code;
    
    // getter/setter 省略
}

额外注意事项 #

• 测试时要验证null场景的序列化结果，确保和旧应用的处理逻辑一致；
• 如果旧应用允许布尔字段返回不带引号的null，可以删除序列化器中对null的特殊处理，直接调用gen.writeNull()。

内容的提问来源于stack exchange，提问作者Justinas Jakavonis