单元测试json序列化与反序列化需验证双向转换的准确性、健壮性与一致性:正向测对象→json的格式、空值、时间、枚举等;反向测json→对象的类型匹配、缺失字段默认值及异常容错;覆盖非法输入、边界场景与特殊类型注解行为。

单元测试 JSON 序列化与反序列化逻辑,核心是验证“对象 ⇄ 字符串”双向转换的准确性、健壮性和一致性。不依赖外部服务,只测行为本身——输入一个对象,是否得到预期 JSON;输入一段 JSON,是否还原为正确对象(含字段值、类型、null 处理、异常边界等)。
覆盖正向序列化:对象 → JSON 字符串
重点检查输出格式是否符合业务约定,比如字段名大小写、空值处理、时间格式、枚举是否按 code 而非 name 输出等。
- 用 Jackson 的 ObjectMapper 调用
writeValueAsString(obj)得到 JSON 字符串 - 对比结果是否与预设的期望字符串完全一致(推荐用
assertEquals+ 美化后的 JSON 字符串字面量) - 若涉及时间、BigDecimal、枚举等特殊类型,确保已配置对应模块(如
JavaTimeModule、自定义SimpleModule) - 测试 null 字段是否被忽略(
objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL))或保留为null
覆盖反向反序列化:JSON 字符串 → 对象
验证字符串能否安全、准确地重建为 Java 对象,尤其注意类型匹配、缺失字段默认值、非法输入的容错性。
- 调用
objectMapper.readValue(jsonString, TargetClass.class) - 断言重建对象的各字段值(包括嵌套对象、集合内容)与原始对象一致
- 测试 JSON 中缺少某个非必需字段时,目标对象对应属性是否为 null 或默认值(取决于构造方式和注解)
- 对必填字段缺失或类型错配(如把字符串传成数字),确认是否抛出
JsonProcessingException并有明确提示
专门验证枚举等特殊类型的双向行为
枚举默认序列化为 name,但业务常需按 code 或 message 输出。测试必须覆盖注解生效性及容错逻辑。
- 若使用
@JsonValue+@JsonCreator,测试序列化输出是否为指定字段(如1),反序列化"1"是否能正确映射回枚举实例 - 测试传入非法 code(如
-99)是否触发IllegalArgumentException,而非静默失败 - 若用 Fastjson,注意其默认按 name 匹配,需配合
@JSONField(serialzeFeatures = ...)或别名注解,并单独测大小写/空格等模糊场景
模拟真实边界与异常路径
生产环境不会总给你标准 JSON。单元测试要主动“找茬”,提前暴露脆弱点。
- 传入空字符串、纯空白、null 字符串,确认是否抛出明确异常(而非 NPE)
- JSON 格式错误(缺引号、括号不闭合),验证是否捕获
JsonParseException - 字段类型强转失败(如 JSON 中
"age": "abc"绑定到int age),检查是否报MismatchedInputException - 测试超长字符串、深层嵌套、循环引用(需提前配置
DeserializationFeature.FAIL_ON_SELF_REFERENCES等)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











