以问答方式拆解我在 Shop Platform 中对 API 与 event contract 的兼容性保障：BFF 对外用 oasdiff 守 OpenAPI spec；内部 BFF→MS 和 MS→MS 用 JSON Schema 快照补 japicmp 的盲区；Kafka 事件用相同手法加 per-event schemaVersion。

只共享 contracts 往往还不够——按我目前的理解，更稳妥的做法是把 ArchUnit、japicmp、Deprecation/Sunset 头、ignore-unknown、WireMock 这些检查组合起来。本文记录 Shop Platform 里的落地方式和一些可参考资料。