如何让Spring Boot Actuator输出JSON而非XML

嗨，我懂你现在的困扰——自己在项目里配置了XmlMapper处理XML序列化，结果把Actuator的输出也变成了可读性很差的XML，确实挺闹心的😅。

问题的核心在于：你定义的XmlMapper被Spring当成了全局默认的ObjectMapper，Actuator自然会复用这个实例来序列化响应，所以输出就变成XML了。下面给你几个实用的解决办法：

方法一：给XmlMapper自定义命名，不覆盖默认JSON处理器 #

你可以给自己的XmlMapper指定一个专属Bean名称，这样Spring会保留默认的Jackson JSON ObjectMapper作为全局使用，Actuator就能正常输出JSON了。修改你的配置类如下：

@Configuration
@RequiredArgsConstructor
public class JacksonMapperConfig {

    @Bean
    public SimpleModule confidentialFieldJacksonModule() {
        SimpleModule simpleModule = new SimpleModule();
        return simpleModule;
    }

    // 给XmlMapper起自定义名称，避免覆盖默认的objectMapper
    @Bean("customXmlMapper")
    public XmlMapper getXmlMapper(SimpleModule confidentialFieldJacksonModule) {
        XmlMapper xmlMapper = new XmlMapper();
        xmlMapper.registerModule(confidentialFieldJacksonModule);
        return xmlMapper;
    }

    // 仅给JSON的ObjectMapper添加自定义模块
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer(SimpleModule confidentialFieldJacksonModule) {
        return builder -> builder.modules(confidentialFieldJacksonModule);
    }
}

之后你需要使用XML序列化时，通过@Qualifier("customXmlMapper")注解注入这个自定义实例即可。

方法二：直接配置Actuator强制返回JSON #

如果你不想改动现有Mapper代码，最简单的方式是通过配置文件指定Actuator的默认响应媒体类型。在application.properties或application.yml中添加：

application.properties #

management.endpoints.web.accept-media-types=application/json

application.yml #

management:
  endpoints:
    web:
      accept-media-types: application/json

这个配置会让Actuator忽略请求头的Accept参数，强制返回JSON格式的响应，一步到位。

方法三：通过Builder配置区分JSON和XML处理器 #

另一种思路是借助Jackson2ObjectMapperBuilder来构建实例，确保默认Mapper处理JSON，XmlMapper作为单独实例存在：

@Configuration
@RequiredArgsConstructor
public class JacksonMapperConfig {

    @Bean
    public SimpleModule confidentialFieldJacksonModule() {
        SimpleModule simpleModule = new SimpleModule();
        return simpleModule;
    }

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer(SimpleModule confidentialFieldJacksonModule) {
        return builder -> builder.modules(confidentialFieldJacksonModule);
    }

    // 单独构建XmlMapper，不影响全局默认Mapper
    @Bean("customXmlMapper")
    public XmlMapper xmlMapper(Jackson2ObjectMapperBuilder builder, SimpleModule confidentialFieldJacksonModule) {
        XmlMapper xmlMapper = builder.createXmlMapper(true).build();
        xmlMapper.registerModule(confidentialFieldJacksonModule);
        return xmlMapper;
    }
}

这种方式和方法一类似，核心都是避免XmlMapper成为全局默认的序列化器。

你可以根据自己的项目场景选择最适合的方案：如果想快速解决，方法二最省事；如果需要在代码中明确区分JSON和XML的处理逻辑，方法一或三更合适。

备注：内容来源于stack exchange，提问作者greengold