在Java后端开发里,对象转Json算是每天都会碰到的操作。所谓Json美化排版,就是在序列化完成之后,把原本挤成一长串、看起来毫无结构的字符串,重新组织成带换行、带缩进的可读格式。我最近把这件事封装成了一个独立的工具类,平时打印日志、调试接口、造测试数据都用它,顺手整理下来,就是这篇文章。
这个工具解决的核心痛点很简单:光会转JSON不够,转出来的内容还得能看懂。很多人在IDEA里打印一个对象,看到的要么是Object@1a2b3c这种毫无信息量的地址串,要么是一行长得不能再长的compact JSON,嵌套深的报文根本没法肉眼追踪字段。如果你要跟第三方接口联调、排查线上日志、或者给前端展示接口返回结构,这个工具能帮你省掉大量“复制到在线格式化工具里再回贴”的往返时间。
1. 为什么Java开发每天都逃不开对象转JSON
1.1 从一次接口联调说起
有一次我跟外部系统做联调,对方返回的报文里有个多层嵌套的订单结构,里面还有List和Map混在一起的数据。当时我把响应体直接打到了日志里,日志输出的是一整行JSON,长度大概有三四千字符。我盯着控制台想找paymentInfo这个字段,上下翻页翻了好半天都没找到,最后只能把日志内容复制到文本编辑器里手动换行,折腾了十分钟才定位到问题。
这还不是最难受的。后面排查一个问题,需要确认自己组装的请求对象到底长什么样。我用System.out.println(request)打印,结果输出是com.example.dto.OrderRequest@5e9f23b4,连字段值都看不到。那时候我就意识到,日常开发里“把对象转成可读的JSON字符串”这件小事,如果不提前封装好,急用的时候是真耽误事。
很多Spring Boot项目里,Controller反序列化和序列化都是框架自动做的,@RestController一标注,返回的对象自动变成JSON给前端。但框架帮你搞定的场景,恰恰只占了日常开发的一部分。日志调试、接口Mock、测试断言、配置读取、消息队列报文打印,这些场景都需要手动把对象转成JSON,而其中一大部分场景需要的是“美化排版后的JSON”。
1.2 主流JSON库怎么选
Java生态里做对象转JSON,绕不开几个选择:Jackson、Gson、Fastjson,以及Hutool里封装的JSONUtil。我自己用下来,优先级是Jackson优先,Gson备用,Fastjson基本不碰,Hutool适合简单场景。
Jackson是Spring Boot的默认JSON处理库,功能非常全,性能靠谱,社区活跃,已经成了事实上的标准。它能处理泛型反序列化、多态类型、自定义序列化器,几乎所有需求都能找到对应的配置项。Gson的API设计更简洁,上手更快,但处理复杂泛型和自定义序列化时,没有Jackson那么细腻。Fastjson性能确实快,但历史上出过多个安全漏洞,在安全审计严一点的公司里早就被拉黑了,新项目我不会选它。
Hutool的JSONUtil.toJsonPrettyStr(obj)一行代码就能输出美化排版,适合小工具场景。但Hutool是一个工具集合,如果项目里没有引入它,为了一个JSON方法拉进来几十个工具类,成本不太划算。而且真要深度定制(比如日期格式、null值策略、缩进长度),还是得回到Jackson这种专门的库上。
所以我的方案是:基于Jackson封装一个轻量工具类,不引入额外依赖,任何Spring Boot项目都能直接用。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 美化排版的背后:序列化原理与JSON的两种形态
2.1 序列化到底做了什么
要理解“对象转JSON再美化排版”,首先得知道序列化在做什么。Java对象在内存里是一堆堆上的数据结构,有字段名、有引用关系、有类型元数据,但这些结构不能直接通过网络传输或者写进日志文件。JSON是纯文本协议,序列化就是把Java对象内部的字段名和字段值,按照JSON语法转换成字符串。
这个过程看起来简单,实际有很多细节。字段名是camelCase还是snake_case,要不要在序列化时做转换;字段值是null的时候,是输出"field": null还是直接跳过;日期类型是输出时间戳还是格式化好的字符串;对象里有循环引用的时候怎么防止栈溢出。这些都是序列化框架要处理的问题。
Jackson处理这些问题的思路是:反射读取Java Bean的getter方法,拿到每个字段的名称和值,逐层递归处理嵌套对象和集合,最后拼装成JSON文本。它默认只认getter,也就是“读取”能力。如果一个类没有getter,或者字段前面没有遵循标准命名,序列化结果就会出问题,后面我会专门讲这个坑。
2.2 JSON的紧凑格式与美化格式
JSON文本本身允许两种呈现方式。第一种是紧凑格式(compact),比如:
json复制{"orderId":"20250112001","amount":99.9,"items":[{"name":"Java编程思想","price":79.9}]}
这种格式所有内容挤在一行,占用空间小,是网络传输的首选。浏览器Network面板里看到的请求响应,默认就是这种形态。
第二种是美化格式(pretty),比如:
json复制{
"orderId" : "20250112001",
"amount" : 99.9,
"items" : [ {
"name" : "Java编程思想",
"price" : 79.9
} ]
}
这种格式加入了换行和缩进,层级关系一目了然。Log日志、接口调试、文档展示,都适合用美化格式。
Jackson里控制这两种输出的核心开关是SerializationFeature.INDENT_OUTPUT。开启了它,ObjectMapper在序列化时就会调用默认的DefaultPrettyPrinter进行排版;不开启,输出紧凑格式。
2.3 为什么“自带美化排版”这么重要
有人可能会说,调试的时候把JSON复制到在线工具里格式化一下不就行了?问题在于,你不可能每次都在日志和在线工具之间来回切换,尤其是线上环境,日志堆积如山,每一条都要复制出去格式化,效率低到难以想象。
更重要的是,很多线上问题的排查窗口非常短。日志
