confluent-schema-registry

用途：面向 Kafka 生态，提供 Confluent Schema Registry 的架构管理专家知识，帮助管理 Avro、Protobuf 和 JSON Schema，并指导架构演进与兼容性选择。

主要能力：

1. 架构格式对比：Avro（二进制、演进支持好、消息小，适合高吞吐与数据仓库）、Protobuf（强类型 .proto、语言无关、编码高效，适合多语言与 gRPC）、JSON Schema（文本可读、易调试、体积大，适合开发调试与 REST API）。
2. 兼容性模式：BACKWARD（默认，推荐生产）、FORWARD、FULL、NONE（仅开发），以及 BACKWARD_TRANSITIVE、FORWARD_TRANSITIVE、FULL_TRANSITIVE 严格模式。
3. 演进策略：新增可选字段并设默认值、移除可选字段、用联合类型处理类型变化；禁止改字段类型、删必填字段、重命名字段（应新增并弃用旧字段）。
4. 命名规范：命名空间如 com.company.domain.EntityName；主题命名如 <topic-name>-value、<topic-name>-key。
5. 校验与注册：通过 REST API 检查兼容性并注册架构，例如 curl -X POST http://localhost:8081/compatibility/subjects/users-value/versions/latest 与 curl -X POST http://localhost:8081/subjects/users-value/versions。
6. 常见问题排查：兼容性错误、Subject 未找到、反序列化失败（Unknown magic byte，消息格式为 magic_byte(1)+schema_id(4)+payload）。

使用方式：在需要架构演进、兼容性模式选择、架构校验、注册、问题调试或格式对比时调用。生产端可用 @kafkajs/confluent-schema-registry 注册并编码，消费端解码。

适用场景：Kafka 数据管道、数据仓库与 ETL、多语言服务、gRPC 集成、REST API 开发调试。

限制：资料未提供具体收费、平台支持范围与性能基准数据；NONE 模式不建议用于生产。