如何禁用可选字段增减引发的PROPERTY_REMOVED_FROM_CLOSED_CONTENT_MODEL兼容性报错？

针对你使用Draft-7 JSON Schema的CLOSED_CONTENT_MODEL、BACKWARD兼容模式，移除非必填字段后触发PROPERTY_REMOVED_FROM_CLOSED_CONTENT_MODEL不兼容提示的问题，可通过以下方式禁用这类判定：

1. 修改Schema Registry全局配置 #

在Confluent Schema Registry的schema-registry.properties配置文件中添加参数，全局忽略可选字段移除的兼容性检查：

json.schema.compatibility.check.optional.field.removal=false

该参数会让BACKWARD兼容模式不再将可选字段的移除判定为不兼容。修改后需重启Schema Registry生效。

2. 为特定主题单独配置 #

若不想修改全局规则，可通过REST API为目标主题单独设置精细兼容性配置：

curl -X PUT -H "Content-Type: application/vnd.schemaregistry.v1+json" \
  --data '{"compatibility": "BACKWARD", "jsonSchemaCompatibility": {"checkOptionalFieldRemoval": false}}' \
  {{base_url}}/config/your-subject-name

将your-subject-name替换为实际主题名称即可。

3. 关键注意事项 #

• 上述配置仅针对JSON Schema生效，不影响Avro等其他格式的兼容性检查。
• 若旧数据中可能包含已移除的可选字段，即使禁用了兼容性检查，新的CLOSED_CONTENT_MODEL schema仍然会拒绝这类旧数据（因为additionalProperties: false会阻止未定义字段）。如果需要旧数据能通过新schema验证，你需要：
  • 暂时关闭CLOSED_CONTENT_MODEL（生成schema时设置additionalProperties: true）；
  • 或在新schema中保留该字段并标记为deprecated，后续再彻底移除。

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