为何JSON Schema校验器抛出多异常而非简洁校验失败汇总？

现象原因 #

你遇到的问题本质是JSON Schema校验库的错误收集策略导致的：

• oneOf的校验逻辑要求输入必须且只能匹配其中一个子schema。但多数Java校验库会遍历所有子schema进行完整校验，收集所有校验失败的细节，而不是只关注oneOf的最终匹配数量。
• 你的输入同时满足前两个子schema（包含x、y），触发oneOf的“匹配多个schema”错误；同时第三个子schema要求必须包含z，输入不满足，所以库会额外抛出“缺少必填键[z]”的错误。这些错误都是校验过程中产生的，库默认会全部返回。

符合需求的Java库 #

以下几个库支持自定义错误处理或默认聚焦核心逻辑错误：

• Jackson JSON Schema Validator：可以通过实现ValidationErrorHandler接口，自定义过滤规则，只保留oneOf相关的顶层错误，忽略子schema的个别缺失错误。
• Everit JSON Schema：提供了灵活的错误处理器配置，能够过滤掉子schema的次要校验错误，只返回与顶层约束（如oneOf）相关的核心错误信息。
• org.everit.json.schema：该库的最新版本优化了oneOf的错误输出逻辑，默认优先提示“匹配多个schema”的核心错误，同时允许通过配置关闭子schema的细节错误输出。

部分库需要手动调整校验配置，比如关闭全量错误收集，开启“只收集顶层逻辑错误”的模式，才能得到你预期的单一错误信息。

内容的提问来源于stack exchange，提问作者Sri Harsha