返回结果中出现 “$ref“:“$.data[0]“ 的原因及其解决办法

问题情景

在与前端进行接口调试时，接口数据返回了如下形式的数据，导致前端部分内容显示异常。

问题根因

使用FastJson的JSONArray类型作为返回数据，当向JSONArray对象中添加JSONObject对象，而JSONObject对象中包含相同的节点数据时，FastJson会防止返回数据栈溢出的问题，自动将JSONArray中相同的节点数据使用引用方式代替。

// com.alibaba.fastjson.serializer.JavaBeanSerializer

    public boolean writeReference(JSONSerializer serializer, Object object, int fieldFeatures) {
        SerialContext context = serializer.context;
        int mask = SerializerFeature.DisableCircularReferenceDetect.mask;
        if (context == null || (context.features & mask) != 0 || (fieldFeatures & mask) != 0) {
            return false;
        }

        if (serializer.references != null && serializer.references.containsKey(object)) {
            serializer.writeReference(object);
            return true;
        } else {
            return false;
        }
    }

解决办法 

找到代码里的拦截器，在对应的FastJsonConfig上
添加如下配置：

// 禁止循环引用
SerializerFeature.DisableCircularReferenceDetect

​
 @Bean
    public HttpMessageConverters fastJsonHttpMessageConverters() {
        // 1.定义一个converters转换消息的对象
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
        // 2.添加fastjson的配置信息，比如: 是否需要格式化返回的json数据
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        fastJsonConfig.setSerializerFeatures(SerializerFeature.PrettyFormat,
                // 禁止循环引用
                SerializerFeature.DisableCircularReferenceDetect);
        fastJsonConfig.setSerializeFilters(new ValueDesensitizeFilter());//添加自己写的拦截器
        // 3.在converter中添加配置信息
        fastConverter.setFastJsonConfig(fastJsonConfig);
        // 4.将converter赋值给HttpMessageConverter
        HttpMessageConverter<?> converter = fastConverter;
        // 5.返回HttpMessageConverters对象
        return new HttpMessageConverters(converter);
    }

​