如何用Jackson处理Spring Boot循环依赖并实现User ID序列化

针对你遇到的循环依赖下Item序列化需求，以下是几种可行的实现方案：

方法1：使用@JsonIdentityReference配合@JsonIdentityInfo #

保留User类的身份标识注解，同时在Item的User字段上强制序列化仅输出ID：

User类代码 #

import com.fasterxml.jackson.annotation.JsonIdentityInfo;
import com.fasterxml.jackson.annotation.ObjectIdGenerators;
import java.util.List;
import java.util.UUID;

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class User {
    private UUID id;
    private String fullName;
    private List<Item> items;

    // 构造器、getter、setter 省略
}

Item类代码 #

import com.fasterxml.jackson.annotation.JsonIdentityReference;
import java.util.UUID;

public class Item {
    private UUID id;
    private String name;

    @JsonIdentityReference(alwaysAsId = true)
    private User user;

    // 构造器、getter、setter 省略
}

此配置会让Item序列化时，user字段直接输出关联User的UUID值，同时解决循环依赖的序列化问题。

方法2：自定义字段序列化器 #

通过自定义序列化逻辑，精准控制User字段的输出内容：

自定义User ID序列化器 #

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

public class UserIdSerializer extends JsonSerializer<User> {
    @Override
    public void serialize(User user, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        // 仅序列化User的id属性
        gen.writeObject(user.getId());
    }
}

在Item类中应用序列化器 #

import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import java.util.UUID;

public class Item {
    private UUID id;
    private String name;

    @JsonSerialize(using = UserIdSerializer.class)
    private User user;

    // 构造器、getter、setter 省略
}

该方式完全脱离Jackson的循环依赖注解，直接定义序列化行为，适配复杂场景。

方法3：@JsonIgnore+@JsonProperty映射 #

忽略原User字段，新增返回ID的方法并映射为序列化字段：

Item类代码 #

import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.UUID;

public class Item {
    private UUID id;
    private String name;

    @JsonIgnore
    private User user;

    @JsonProperty("user")
    public UUID getUserId() {
        return user != null ? user.getId() : null;
    }

    // 构造器、setter、其他getter 省略
}

这种方式简单直观，无需额外注解依赖，通过字段忽略与属性映射实现需求，同时避免循环序列化。

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