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

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