fastjson转化入参字符串的特殊字段名$ref问题

GuessBUG

已于 2022-12-01 17:37:38 修改

阅读量1.6k

点赞数

CC 4.0 BY-SA版权

分类专栏： Java 文章标签： java json

于 2021-10-25 18:11:49 首次发布

本文链接：https://blog.youkuaiyun.com/GuessBUG/article/details/120956593

Java 专栏收录该内容

10 篇文章

订阅专栏

本文探讨了Fastjson在处理JSON对象时遇到的 `$ref` 引用问题，如何通过Feature.DisableCircularReferenceDetect特性解决转化逻辑冲突，并提及不同Fastjson版本对这一规则的影响。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、问题描述

{
    "schema": {
        "originalRef": "Result«object»",
        "$ref": "#/definitions/Result«object»"
    }
}

入参字符串是json格式，可直接转为JSONObject，由于某个字段是$ref，导致调用fastjson的JSON.parseObject(String text)方法出现问题。
1、问题一：$ref在第一个字段，转化api报错：
com.alibaba.fastjson.JSONException: syntax error
2、问题二：$ref在第二个字段，则转化api未报错，但是同级所有字段全部消失，只留下$ref这个字段，且值变为@:
在这里插入图片描述
注意：若返回转化后的json给前端，则会报错：Could not write JSON: Infinite recursion (StackOverflowError); nested exception is com.fasterxml.jackson.databind.JsonMappingException: Infinite recursion (StackOverflowError) (through reference chain: 统一返回响应类路径)

二、解决思路

从报错情况和fastjson使用经验判断，$ref是fastjson声明引用属性名，相当于内置字段，外来字段重名会导致转化逻辑。所以考虑处理"引用"这个问题。

三、解决方案

使用转化规则DisableCircularReferenceDetect，即关闭引用。最终代码：

JSON.parseObject(text, Feature.DisableCircularReferenceDetect);

四、小结

1、使用$ref作为入参字段会影响fastjson转化逻辑，需要使用Feature.DisableCircularReferenceDetect转化规则处理；
2、JSON.parseObject(text, Feature.DisableCircularReferenceDetect)，转化规则在1.2.24版本并未生效，1.2.39+版本才生效，1.2.24-1.2.39之间的版本暂未测试。