本文详解如何在 json schema 中约束对象（如 employee）的多个可选字段，使其不能全部为 null，即至少有一个字段必须提供有效值（非 null），适用于 java rest api 的请求体校验场景。
本文详解如何在 json schema 中约束对象（如 employee）的多个可选字段，使其不能全部为 null，即至少有一个字段必须提供有效值（非 null），适用于 java rest api 的请求体校验场景。
在构建基于 JSON Schema 的接口契约（例如配合 SpringDoc、Swagger 或 Jakarta Validation 集成工具）时，常需表达“对象中若干字段均可为空，但不可全部为空”这一业务规则。标准 JSON Schema 本身不支持直接声明“至少一个必填”，但可通过 anyOf 组合逻辑精准建模该语义。
以下是一个完整、可运行的 JSON Schema 片段，用于校验 employee 对象——其 empName、empAge、empAddress、empContact 四个字段均允许为 null 或 object 类型，但禁止全部为 null：
"employee": {
"type": "object",
"default": {},
"properties": {
"empName": { "type": ["object", "null"] },
"empAge": { "type": ["object", "null"] },
"empAddress": { "type": ["object", "null"] },
"empContact": { "type": ["object", "null"] }
},
"anyOf": [
{ "required": ["empName"] },
{ "required": ["empAge"] },
{ "required": ["empAddress"] },
{ "required": ["empContact"] }
]
}⚠️ 关键说明与注意事项：
- "null" 必须加引号：JSON Schema 规范中，null 是字符串字面量，正确写法是 "null"，而非 null（后者在 JSON 中非法）；
- anyOf 的语义是“逻辑或”：上述 anyOf 表达“empName 存在 或 empAge 存在 或 …”，而 required 字段的存在性检查天然排除了 null 值（因 null 不是 object，也不满足 "required" 的存在性要求）；
- 更严谨的等价写法（显式排除 null）如下（推荐用于强类型校验场景）：
"anyOf": [ { "properties": { "empName": { "type": "object" } }, "required": ["empName"] }, { "properties": { "empAge": { "type": "object" } }, "required": ["empAge"] }, { "properties": { "empAddress": { "type": "object" } }, "required": ["empAddress"] }, { "properties": { "empContact": { "type": "object" } }, "required": ["empContact"] } ]此写法明确要求对应字段不仅存在，且类型为 object（即非 null），语义更清晰、兼容性更好；
- 若字段实际支持更多类型（如 string、number），请同步扩展 type 数组，例如 "type": ["string", "number", "object", "null"]，并在 anyOf 分支中对应调整；
- 在 Java 后端（如使用 json-schema-validator 库），该 Schema 可无缝集成到请求体校验流程中；若搭配 OpenAPI 3.0，亦可被 Swagger UI 正确渲染并用于客户端表单约束。
总结：通过 anyOf + required（或 properties + type）组合，即可优雅实现“对象中至少一个字段非 null”的业务约束，无需侵入代码逻辑，真正实现契约先行、声明式验证。
