Spring Boot/MVC+AJAX获取JSON异常：返回Jackson序列化ID而非完整对象

数据老陈

2026-5-19

问题诊断与解决方案

嘿，这个问题我之前也碰到过，大概率是@JsonIdentityInfo的默认序列化行为在搞鬼！

为什么会出现这种情况？

你用了@JsonIdentityInfo注解，Jackson为了处理循环引用或者重复对象，会在第一次序列化对象时输出完整结构，后续再遇到同一个对象时，就只输出它的ID（就是你看到的那些数字）。而你说单独调用接口能拿到完整POJO列表，AJAX调用却出现ID，可能有两个原因：

直接调用时，接口返回的对象列表里没有重复/循环引用的对象，而AJAX请求触发的场景下（比如请求参数不同、关联数据加载更多），出现了重复对象；
部分AJAX库的请求头Accept设置和直接调用不同，导致Spring Boot使用了不同的序列化策略（不过这个概率相对低一些）。

解决方案，按优先级推荐：

1. 替换循环引用处理方式（最推荐）

如果@JsonIdentityInfo是用来解决循环引用的，换成更精准的@JsonManagedReference和@JsonBackReference会更可控：

在双向关联的父对象的集合字段上标记@JsonManagedReference（比如User类的List<Order> orders）；
在子对象的父引用字段上标记@JsonBackReference（比如Order类的User user）。
这样序列化时会完整输出父对象及关联的子对象，不会出现ID替代的情况。

2. 调整Jackson序列化配置，禁用ID引用

如果确实需要保留@JsonIdentityInfo，可以通过Spring Boot配置强制让Jackson总是输出完整对象，而不是用ID引用：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 关闭ID引用序列化，强制输出完整对象
        mapper.disable(SerializationFeature.USE_ID_FOR_REFERENCE);
        return mapper;
    }
}

3. 检查并调整AJAX请求头

确保AJAX请求的Accept头明确设置为application/json，避免Spring Boot匹配到不合适的消息转换器：

// 以jQuery为例
$.ajax({
    url: "/your-rest-endpoint",
    method: "GET",
    headers: {
        "Accept": "application/json"
    },
    success: function(response) {
        console.log("完整响应：", response);
    }
});

4. 使用DTO替代实体类返回

如果上面的方法都不适用，可以定义专门的DTO（数据传输对象），只包含前端需要的字段，避免携带实体类中的关联关系，从根源上杜绝循环引用和重复对象的问题：

// 示例DTO，只保留需要的字段
public class ItemDTO {
    private Long id;
    private String name;
    // 省略getter/setter
}

// 在Controller中转换实体为DTO返回
@RestController
public class ItemController {
    @GetMapping("/items")
    public List<ItemDTO> getItems() {
        List<Item> items = itemService.findAll();
        return items.stream()
                    .map(item -> {
                        ItemDTO dto = new ItemDTO();
                        dto.setId(item.getId());
                        dto.setName(item.getName());
                        return dto;
                    })
                    .collect(Collectors.toList());
    }
}

验证步骤

先临时注释掉@JsonIdentityInfo注解，重新启动服务后用AJAX调用接口，如果返回完整对象列表，就可以确认是这个注解的行为导致的问题，再根据你的业务场景选择上面的解决方案即可。

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