OpenAPI 生成器升级：客户端差异与接口契约回归

生成器版本升级可能在不改变接口文档的情况下修改客户端 API、序列化逻辑或文件结构。

将生成器视为构建依赖

固定生成器镜像或版本，并记录模板与额外参数。升级后比较生成文件，重点审查公开方法、认证代码和日期类型处理。

以契约测试确认行为

针对请求路径、查询参数、请求体和错误响应运行契约测试。不要只验证生成代码能编译，还要验证其发出的 HTTP 请求。