如何让Jackson对同类型嵌套实体使用不同的JsonView序列化视图

问题原因 #

Views.FullProfile继承自Views.IdText，使用FullProfile视图序列化根User对象时，序列化上下文会全局生效，嵌套的User对象也会沿用该视图，导致嵌套User的subscribers字段（标注了FullProfile视图）也被序列化，最终出现递归返回冗余数据的问题。

可行解决方案 #

方案1：使用@JsonIgnoreProperties屏蔽嵌套冗余字段（最快实现） #

直接在subscribers字段上添加注解，序列化集合内的User对象时自动忽略subscribers字段，无需额外编码：

@JsonIdentityReference
@JsonIdentityInfo(
        property = "id",
        generator = ObjectIdGenerators.PropertyGenerator.class
)
@JsonView(Views.FullProfile.class)
@JsonIgnoreProperties(value = "subscribers") // 新增这行
private Set<User> subscribers = new HashSet<>();

序列化后嵌套的User只会输出标注了IdText视图的id和username字段，完全符合预期。

注意：如果项目其他场景需要序列化嵌套User的subscribers字段，不要使用该方案，优先选择方案2或3。

方案2：自定义嵌套元素序列化器（灵活扩展） #

如果后续需要调整嵌套User的序列化规则，可以自定义集合元素的序列化器，手动指定嵌套User使用IdText视图序列化：

1. 编写嵌套User序列化器

public class NestedUserSerializer extends StdSerializer<User> {
    public NestedUserSerializer() {
        super(User.class);
    }

    @Override
    public void serialize(User user, JsonGenerator gen, SerializerProvider provider) throws IOException {
        ObjectMapper mapper = (ObjectMapper) gen.getCodec();
        // 手动指定使用IdText视图序列化嵌套User
        mapper.writerWithView(Views.IdText.class).writeValue(gen, user);
    }
}

2. 在subscribers字段上指定序列化器

@JsonIdentityReference
@JsonIdentityInfo(
        property = "id",
        generator = ObjectIdGenerators.PropertyGenerator.class
)
@JsonView(Views.FullProfile.class)
@JsonSerialize(contentUsing = NestedUserSerializer.class) // 新增这行
private Set<User> subscribers = new HashSet<>();

方案3：DTO分层映射（企业级项目推荐） #

避免实体类和序列化规则强耦合，从业务层面拆分数据传输对象，彻底解决递归问题：

1. 定义基础用户DTO，仅包含需要对外暴露的基础字段

public class UserBasicDTO {
    private Long id;
    private String username;
    // 省略Getter、Setter
}

2. 定义完整用户信息DTO，嵌套集合使用基础DTO类型

public class UserFullDTO {
    private Long id;
    private String username;
    private Set<UserBasicDTO> subscribers;
    // 省略Getter、Setter
}

3. 业务逻辑层将User实体转换为UserFullDTO返回即可，后续字段调整无需修改实体类注解，可维护性更强。

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