| 结构 | servers、channels、operations、components 分层描述 |
|---|---|
| 价值 | 事件契约进入评审与流水线校验 |
| 配套 | 与 Schema Registry、代码生成工具衔接 |
事件契约的消费者识别更难：上线前梳理订阅方清单，废弃事件需通知到具体团队。
AsyncAPI
面向事件驱动接口的描述规范，用 channels、operations 与 messages 描述消息通道与载荷；定位类似异步场景的 OpenAPI，支撑文档、代码生成与治理。
易错点
- 只描述生产者不梳理消费者，事件变更无人知晓
- 事件载荷无版本标识，消费者无法选择解析策略
数据来源与参考
- AsyncAPI 规范（asyncapi.com）
- AsyncAPI Initiative 文档