梳理 REST API 版本管理的四种常见策略，对比 Spring Boot 4 原生支持与历史实现方案，并整理实现过程中比较容易踩到的问题。

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

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