本文介绍一种基于 json schema 思想的模板驱动校验方法，通过递归比对预定义模板与实际 json 数据的结构、类型及必填性，替代冗长的手动字段校验代码，显著提升可维护性与扩展性。
在处理包含 48+ 字段的复杂 JSON 响应时，逐字段 get() + 类型强转 + 空值判断的硬编码校验方式不仅重复度高、易出错（如 == null && .isEmpty() 逻辑错误），还严重违背开闭原则——新增字段需同步修改校验逻辑，维护成本极高。
更优解是采用声明式模板校验（Template-Driven Validation）：预先定义一个轻量 JSON 模板，明确每个字段的存在性、数据类型、非空要求及嵌套结构，再通过统一递归校验器自动执行一致性检查。该方案融合了策略模式（校验规则集中封装）与组合模式（递归处理嵌套对象/数组）的思想，无需引入第三方 Schema 库即可快速落地。
✅ 核心实现步骤
-
定义校验模板（JSON String）
模板仅描述结构契约，不关心业务值。字符串字段用 "" 占位，数组用 []，数字用 0，对象用 {}：{ "productName": "", "offerStartDate": "", "offerEndDate": "", "offerAttributes": [], "offerSpecifications": { "price": 0 } } -
统一递归校验器（类型安全 + 必填保障）
使用 Jackson 的 JsonNode 进行类型感知校验，关键逻辑如下：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 dataValue = data.get(key); // 【必填性】字段缺失或为 null if (dataValue == null || dataValue.isNull()) { throw new ValidationException("Missing required field: " + key); } // 【类型一致性】模板类型 vs 实际值类型 if (field.getValue().getNodeType() != dataValue.getNodeType()) { throw new ValidationException( String.format("Type mismatch for '%s': expected %s, got %s", key, field.getValue().getNodeType(), dataValue.getNodeType()) ); } // 【语义校验】按类型差异化处理 switch (field.getValue().getNodeType()) { case STRING: if (dataValue.asText().trim().isEmpty()) { throw new ValidationException("Empty string not allowed for field: " + key); } break; case OBJECT: validate(field.getValue(), dataValue); // 递归校验子对象 break; case ARRAY: if (dataValue.isEmpty()) { throw new ValidationException("Array '" + key + "' must not be empty"); } break; case NUMBER: // 可扩展：校验数值范围、精度等 break; case BOOLEAN: // 可扩展：校验布尔值语义（如 status 字段必须为 true） break; } } } -
使用示例（一行调用，全量覆盖）
ObjectMapper mapper = new ObjectMapper(); JsonNode template = mapper.readTree(templateJson); JsonNode data = mapper.readTree(jsonString); validate(template, data); // 自动完成全部 48+ 字段校验
⚠️ 注意事项与增强建议
- 异常设计：将 Exception 替换为自定义 ValidationException，携带字段路径（如 offerSpecifications.price）和错误码，便于日志追踪与前端友好提示。
- 可选字段支持：若某些字段为可选，可在模板中用特殊标记（如 "optional_field?": ""），校验器跳过 ? 后缀字段。
- 性能优化：对高频校验场景，可将 template 预解析为 JsonNode 并缓存，避免重复解析。
- 进阶演进：当校验规则进一步复杂（如正则校验、日期格式、条件依赖），建议迁移至标准 JSON Schema + json-schema-validator 库，实现行业通用规范。
此方案将校验逻辑从“代码”下沉为“配置”，大幅提升可读性、可测试性与协作效率——产品只需修改 JSON 模板，开发无需触碰校验逻辑，真正实现关注点分离。
