以问答方式拆解我在 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 里的落地方式和一些可参考资料。

BFF 与微服务之间到底该共享到哪一步？本文从 Shop Platform 的 monorepo 实践出发，拆解共享 contracts、共享 client、契约测试三种思路在 polyrepo 下的 tradeoff，并记录我目前更倾向的落地方式。