不修改DTO类，如何在特定REST服务中忽略JSON响应字段？

这个问题我之前也碰到过，核心原因是你给DTO类直接加了@JsonFilter注解，这会让所有序列化这个DTO的ObjectMapper实例都要求配置对应的过滤器——而其他不需要过滤的场景没配置，自然就报错了。既然DTO不能修改，我们得换个思路，让过滤规则只在那个特定REST服务的场景下生效，给你两个实用的解决方案：

方案1：给特定REST服务配置专属的ObjectMapper #

如果你用的是Spring（Boot），可以专门定义一个带过滤器的ObjectMapper Bean，只在目标Controller里使用它，其他地方还是用默认的Mapper，这样就不会影响全局。

首先定义自定义Mapper的配置类：

@Configuration
public class CustomMapperConfig {
    @Bean("filteredRestMapper")
    public ObjectMapper filteredRestMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 配置我们需要的过滤器
        SimpleFilterProvider filterProvider = new SimpleFilterProvider();
        filterProvider.addFilter(
            "restrictionFilter",
            SimpleBeanPropertyFilter.filterOutAllExcept("name", "sizeInByte")
        );
        mapper.setFilterProvider(filterProvider);
        return mapper;
    }
}

然后在你的目标Controller里注入这个专属Mapper，用它来序列化返回结果：

@RestController
public class TargetRestController {
    @Autowired
    @Qualifier("filteredRestMapper")
    private ObjectMapper filteredRestMapper;

    @GetMapping("/your-specific-endpoint")
    public ResponseEntity<String> getFilteredDtoList() {
        List<YourDTO> dtoList = // 从业务逻辑获取DTO列表
        try {
            String filteredJson = filteredRestMapper.writeValueAsString(dtoList);
            return ResponseEntity.ok(filteredJson);
        } catch (JsonProcessingException e) {
            // 这里可以根据业务需求处理异常，比如返回500
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("序列化失败");
        }
    }
}

方案2：使用Jackson MixIn动态添加过滤注解（更灵活） #

如果不想给整个DTO加上@JsonFilter（毕竟会影响全局），可以用MixIn功能——它能在不修改原DTO类的前提下，动态给它添加注解，而且只在特定的ObjectMapper实例中生效。

第一步，创建一个MixIn接口，只需要加上我们需要的@JsonFilter注解：

@JsonFilter("restrictionFilter")
public interface YourDTOMixIn {
    // 不需要写任何方法，只是用来承载注解
}

然后在目标服务的序列化逻辑里，创建一个临时的ObjectMapper，注册这个MixIn并配置过滤器：

@GetMapping("/your-specific-endpoint")
public ResponseEntity<String> getFilteredDtoList() {
    List<YourDTO> dtoList = // 获取DTO列表
    try {
        ObjectMapper mapper = new ObjectMapper();
        // 给当前Mapper注册MixIn，仅这个Mapper会识别DTO上的过滤注解
        mapper.addMixIn(YourDTO.class, YourDTOMixIn.class);
        // 配置过滤器规则
        SimpleFilterProvider filterProvider = new SimpleFilterProvider();
        filterProvider.addFilter(
            "restrictionFilter",
            SimpleBeanPropertyFilter.filterOutAllExcept("name", "sizeInByte")
        );
        mapper.setFilterProvider(filterProvider);
        
        String filteredJson = mapper.writeValueAsString(dtoList);
        return ResponseEntity.ok(filteredJson);
    } catch (JsonProcessingException e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("序列化失败");
    }
}

这个方案的好处是完全不影响其他使用该DTO的场景，因为MixIn和过滤器只在我们创建的这个临时Mapper里生效。

为什么原来的方法会报错？ #

你直接在DTO上添加@JsonFilter后，所有序列化这个DTO的Jackson实例都会去查找ID为restrictionFilter的过滤器，但其他场景并没有配置FilterProvider，所以Jackson就会抛出Cannot resolve PropertyFilter with id 'restrictionFilter'; no FilterProvider configured的错误。上面两个方案都是通过隔离过滤规则的生效范围来解决这个问题的。

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