JSON Schema Draft v4中anyOf与additionalProperties报错问题咨询

你的报错根源在于根级 Schema 的约束与 anyOf 子 Schema 的需求冲突，具体逻辑如下：

1. 根级 additionalProperties: false 的核心问题 #

你在根级 Schema 中设置了 "additionalProperties": false，但根级并未定义 properties 字段。根据 JSON Schema Draft 04 的规则：

• additionalProperties: false 的作用是禁止对象包含任何未在当前 Schema 的 properties 中明确列出的属性。
• 由于根级没有定义 properties，相当于没有允许任何属性存在。这就导致，无论你的实例是包含 "series" 还是 "movie"，都会被根级 Schema 判定为「额外属性」，从而触发报错。

2. 为什么修改这两个位置能解决问题 #

（1）允许根级的 additionalProperties #

当你将根级的 "additionalProperties" 改为 true（或直接移除该约束）：

• 根级不再限制实例的属性，此时 anyOf 中的子 Schema 会接管验证逻辑。每个子 Schema 里的 additionalProperties: false 会确保：
  • 如果实例包含 "series"，则不能有其他额外属性；
  • 如果实例包含 "movie"，同样不能有其他额外属性。
    这样既满足了「只能是剧集或电影」的需求，又不会出现根级约束的冲突。

（2）允许 <-Here 位置的 additionalProperties #

当你将 anyOf 子 Schema 中的 "additionalProperties" 改为 true：

• 这相当于放宽了子级的约束，允许实例在包含 "series" 或 "movie" 的同时，还能有其他属性。但这种做法并不推荐——因为它会允许不符合预期的额外属性存在。
• 报错消失的原因是，此时子 Schema 不再限制额外属性，实例能通过子 Schema 的验证；但根级的 additionalProperties: false 其实仍在生效，这会导致逻辑矛盾（比如实例有额外属性时，根级应该报错但实际可能因 validator 实现问题未触发）。

正确的解决方案 #

最合理的做法是移除根级的 "additionalProperties": false，保留 anyOf 子 Schema 中的 "additionalProperties": false。这样：

• 根级不限制属性，交由 anyOf 来判断实例属于剧集还是电影；
• 每个子 Schema 确保对应的实例没有额外属性，完全符合预期结构。

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