本文介绍一种基于 json 模板 + 递归遍历的轻量级验证方案，替代传统硬编码字段判空逻辑，显著降低 48+ 字段 json 的验证冗余度，提升健壮性、可读性与可维护性。
在处理结构复杂、字段繁多（如 48+ 字段）的 JSON 输入时，逐字段 map.get("xxx") + 手动类型强转 + 空值/空字符串/空集合三重判断的写法不仅高度重复、易出错、难以维护，还严重违反开闭原则——新增字段需同步修改验证逻辑，且无法统一约束嵌套结构（如 offerSpecifications.price 是否存在、是否为数字）。
更优解是采用 「Schema-like 模板驱动验证」：定义一个轻量 JSON 模板（Template），明确每个字段的存在性、类型、非空性（对字符串/数组）及嵌套结构，再通过递归比对模板与实际数据，自动完成全路径校验。
✅ 核心实现思路
- 模板定义：用标准 JSON 字符串描述期望结构（字段名、类型占位符、默认值），不依赖外部 Schema 格式（如 JSON Schema），零学习成本；
-
递归校验：遍历模板所有键，对每个字段执行：
- ✅ 存在性检查（data.get(key) != null）；
- ✅ 类型一致性（templateNode.getNodeType() == dataNode.getNodeType()）；
- ✅ 值有效性（字符串非空、数组非空、对象递归进入）；
- 错误语义化：抛出含路径信息的异常（如 "Missing offerSpecifications.price"），便于快速定位。
? 示例代码（精简可复用版）
ObjectMapper mapper = new ObjectMapper();
// 1. 定义结构化模板（仅声明结构，无需真实值）
String templateJson = """
{
"productName": "",
"offerStartDate": "",
"offerEndDate": "",
"offerAttributes": [],
"offerSpecifications": {
"price": 0.0
}
}
""";
JsonNode template = mapper.readTree(templateJson);
JsonNode data = mapper.readTree(yourJsonString); // 实际输入 JSON
validate(template, data); // 启动校验public void validate(JsonNode template, JsonNode data) throws ValidationException {
Iterator<Map.Entry<String, JsonNode>> fields = template.fields();
while (fields.hasNext()) {
Map.Entry<String, JsonNode> field = fields.next();
String key = field.getKey();
JsonNode dataNode = data.get(key);
// 【必存在】字段缺失
if (dataNode == null || dataNode.isNull()) {
throw new ValidationException("Missing required field: " + key);
}
// 【类型一致】基本类型/容器类型匹配
if (!field.getValue().getNodeType().equals(dataNode.getNodeType())) {
throw new ValidationException(
String.format("Type mismatch at '%s': expected %s, got %s",
key,
field.getValue().getNodeType(),
dataNode.getNodeType())
);
}
// 【值有效】按类型精细化校验
switch (field.getValue().getNodeType()) {
case STRING:
if (dataNode.asText().trim().isEmpty()) {
throw new ValidationException("Empty string not allowed for field: " + key);
}
break;
case ARRAY:
if (dataNode.isEmpty()) {
throw new ValidationException("Array '" + key + "' must not be empty");
}
break;
case OBJECT:
validate(field.getValue(), dataNode); // 递归校验嵌套对象
break;
case NUMBER:
case BOOLEAN:
// 数值/布尔类型默认接受（可按需扩展范围校验，如 price > 0）
break;
default:
// 其他类型（null、missing）已在前置检查拦截
}
}
}
// 自定义异常，便于上层捕获和日志追踪
public static class ValidationException extends Exception {
public ValidationException(String message) { super(message); }
}⚠️ 注意事项与增强建议
- 模板即文档：将 templateJson 提取为 resources/validation-template.json，成为 API 的契约文档，前后端共用；
- 支持可选字段：若某字段允许缺失，模板中设为 null，校验时跳过该键（需在 validate() 中增加 if (field.getValue().isNull()) continue;）；
- 深度定制：可在模板中嵌入元数据（如 "price": {"type": "number", "min": 0.01, "required": true}），升级为简易 JSON Schema 解析器；
- 性能优化：对高频调用场景，预编译 template 为不可变树结构，避免每次解析；
- 与 Spring 集成：结合 @Valid + 自定义 ConstraintValidator<JsonTemplate, String>，实现注解式校验。
✅ 总结
相比原始 48× 手动判空代码，模板驱动验证将校验逻辑从“过程式”转向“声明式”：
? 减少 90%+ 冗余代码（无重复 get()、instanceof、isEmpty()）；
? 天然支持任意深度嵌套（递归自动穿透 offerSpecifications.price）；
? 错误可追溯、易调试、易协作（模板即接口契约）；
? 零第三方依赖（仅需 Jackson），轻量、可控、易于演进。
从此，JSON 验证不再是维护噩梦，而是一份清晰、自解释、可持续生长的结构契约。
