四种常见的 REST API 版本管理策略各有代价，Spring Boot 4 的原生支持进来之后，跟历史实现方案怎么取舍、哪些坑容易踩到，得重新对一遍。

在 Gateway + BFF + Domain Service 架构下，记录一种用 Spring Cloud Gateway MVC 和 SpringDoc 聚合 OpenAPI 文档的做法，方便前后端协作和接口自查。

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