API 与 event contract 的兼容性保障按问答拆开：BFF 对外用 oasdiff 守 OpenAPI spec，内部 BFF 到 MS、MS 到 MS 用 JSON Schema 快照补 japicmp 的盲区，Kafka 事件再加 per-event schemaVersion。

介绍 OpenAPI 3.1 相比 3.0 的几项核心变化：JSON Schema 2020-12 对齐、nullable 语义重构、webhooks 原生支持，以及我在项目里做升级验证时看到的收益与边界。