Java处理JSON编程实用技巧

以下是2025–2026年视角下，Java 处理 JSON最实用、最常被用到的技巧汇总（主要基于目前最主流的几种库）。

目前主流选择排序（推荐优先级）：

1. 最推荐的现代依赖（2025-2026主流写法）

<!-- Jackson（强烈推荐） --><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.17.2</version><!-- 或更新版本 --></dependency><!-- 如果需要JDK17+记录类、虚拟记录等支持 --><dependency><groupId>com.fasterxml.jackson.datatype</groupId><artifactId>jackson-datatype-jdk17</artifactId><version>2.17.2</version></dependency><!-- Fastjson2（性能党选择） --><dependency><groupId>com.alibaba.fastjson2</groupId><artifactId>fastjson2</artifactId><version>2.0.50</version><!-- 关注安全公告 --></dependency><!-- Gson（轻量选择） --><dependency><groupId>com.google.code.gson</groupId><artifactId>gson</artifactId><version>2.11.0</version></dependency>

2. 最高频实用技巧清单（带代码）

技巧1：优雅处理 LocalDateTime / Instant（最痛点之一）

// Jackson 推荐写法（全局配置一次即可）ObjectMappermapper=JsonMapper.builder().addModule(newJavaTimeModule())// 支持 java.time.*.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS).build();// 或使用注解（更精细控制）publicclassOrder{@JsonFormat(pattern="yyyy-MM-dd HH:mm:ss",timezone="GMT+8")privateLocalDateTimecreateTime;@JsonFormat(pattern="yyyy-MM-dd")privateLocalDatedeliveryDate;}

Fastjson2 等价写法：

JSONWriter.Feature.WriteDateUseDateFormat,JSONWriter.Feature.WriteLocalDateTimeAsString

技巧2：忽略 null 值 & 空集合（减小报文体积）

// Jacksonmapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);// null不输出mapper.setSerializationInclusion(JsonInclude.Include.NON_EMPTY);// 空集合/空串不输出// 字段级别@JsonInclude(JsonInclude.Include.NON_NULL)privateStringremark;

技巧3：字段名风格自动转换（最常用场景）

// Jackson - snake_case ↔ camelCasemapper.registerModule(newSimpleModule().addSerializer(String.class,newPropertyNamingStrategies.SnakeCaseStrategy()...));// 或全局配置（Spring Boot常用）@BeanpublicObjectMapperobjectMapper(){returnJsonMapper.builder().propertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE).build();}

技巧4：处理未知字段不报错（向前兼容神器）

// Jacksonmapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES,false);// Fastjson2JSONReader.Feature.IgnoreAutoTypeNotMatch,JSONReader.Feature.ErrorOnUnknown

技巧5：泛型集合反序列化（最容易出错的地方）

// Jackson 推荐写法List<User>users=mapper.readValue(json,mapper.getTypeFactory().constructCollectionType(List.class,User.class));// 更复杂的嵌套泛型Map<String,List<User>>data=mapper.readValue(json,newTypeReference<>(){});

Gson 等价：

Typetype=newTypeToken<List<User>>(){}.getType();List<User>users=gson.fromJson(json,type);

技巧6：超大 JSON → 流式处理（内存杀手克星）

// Jackson 流式读取（推荐）try(JsonParserparser=mapper.createParser(hugeJsonInputStream)){while(parser.nextToken()!=null){if(parser.currentToken()==JsonToken.FIELD_NAME){Stringfield=parser.getCurrentName();if("orders".equals(field)){parser.nextToken();// 进入数组while(parser.nextToken()!=JsonToken.END_ARRAY){Orderorder=mapper.readValue(parser,Order.class);// 逐条处理}}}}}

技巧7：JSON Patch / JSON Merge Patch（声明式修改）

// Jackson 支持 RFC 6902JsonNodepatchNode=mapper.readTree(patchJson);ObjectMappermapperWithPatch=JsonMapper.builder().build();JsonNodetarget=mapperWithPatch.readerFor(User.class).with(newJsonPatch(patchNode)).readValue(originalUserJson);

技巧8：快速脱敏 / 过滤敏感字段（合规必备）

// Jackson 方式一：@JsonFilter@JsonFilter("sensitiveFilter")publicclassUser{...}// 方式二：自定义 SerializerpublicclassMaskPhoneSerializerextendsStdSerializer<String>{@Overridepublicvoidserialize(Stringvalue,JsonGeneratorgen,SerializerProviderp){if(value!=null&&value.length()==11){gen.writeString(value.substring(0,3)+"****"+value.substring(7));}}}

技巧9：Fastjson2 高性能实用配置（追求极致时用）

JSONWriterjsonWriter=JSONWriter.ofUTF8().setFeatures(JSONWriter.Feature.WriteNullsAsEmptyString,JSONWriter.Feature.PrettyFormatIfLengthGt512,JSONWriter.Feature.NotWriteDefaultValue);

快速选择建议表（2026视角）

你目前项目用的是哪个库？或者主要痛点是什么（日期、泛型、性能、内存、字段风格……）？可以讲得更具体一些，我可以给你更针对性的写法。