Spring Boot如何全局配置Jackson的JsonAutoDetect序列化无Getter私有字段

问题原因 #

之前的配置未生效大概率是Spring MVC的消息转换器未加载自定义的Jackson规则，最常见的触发场景是项目中使用了@EnableWebMvc注解接管了Spring MVC自动配置，导致默认的Jackson自动配置失效，或者存在其他自定义消息转换器覆盖了默认逻辑。

有效配置方案 #

方案1：配置文件（无自定义Web配置时优先用） #

在application.properties中添加如下配置即可，注意不要和@EnableWebMvc同时使用：

spring.jackson.visibility.field=ANY
# 可选配置：关闭Getter、IsGetter检测，避免和少量存在Getter的字段逻辑冲突
spring.jackson.visibility.getter=NONE
spring.jackson.visibility.is-getter=NONE

方案2：自定义消息转换器（兼容性最强，覆盖所有场景） #

直接注册自定义的Jackson消息转换器，强制Spring MVC使用你指定的序列化规则，不受其他Web配置影响：

import com.fasterxml.jackson.annotation.JsonAutoDetect;
import com.fasterxml.jackson.annotation.PropertyAccessor;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;

@Configuration
public class JacksonGlobalConfig {
    @Bean
    public MappingJackson2HttpMessageConverter customJacksonMessageConverter() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 全局配置所有类的字段可见性为ANY，私有字段无需Getter即可序列化
        objectMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
        // 可根据业务需求选择是否关闭Getter检测
        objectMapper.setVisibility(PropertyAccessor.GETTER, JsonAutoDetect.Visibility.NONE);
        objectMapper.setVisibility(PropertyAccessor.IS_GETTER, JsonAutoDetect.Visibility.NONE);
        return new MappingJackson2HttpMessageConverter(objectMapper);
    }
}

坑点排查 #

• 如果项目中存在标注@EnableWebMvc的配置类，需要在该类中手动注册上述customJacksonMessageConverter，@EnableWebMvc会完全禁用Spring Boot的Web自动配置，默认的Jackson配置逻辑不会执行。
• 如果存在WebMvcConfigurer实现类重写了configureMessageConverters方法，且方法内调用了converters.clear()清空默认转换器，需要在该方法内手动添加上述自定义消息转换器实例。
• 检查业务类是否标注了优先级更高的Jackson注解（如@JsonAutoDetect、@JsonIgnore），类上的注解会覆盖全局配置规则。

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