.net webapi 实现 接口版本控制并打通swagger支持

🚀 优质资源分享 🚀

学习路线指引（点击解锁）	知识定位	人群定位
🧡 Python实战微信订餐小程序 🧡	进阶级	本课程是python flask+微信小程序的完美结合，从项目搭建到腾讯云部署上线，打造一个全栈订餐系统。
💛Python量化交易实战💛	入门级	手把手带你打造一个易扩展、更安全、效率更高的量化交易系统

我们在开发 webapi 项目时如果遇到 api 接口需要同时支持多个版本的时候，比如接口修改了入参之后但是又希望支持老版本的前端（这里的前端可能是网页，可能是app,小程序 等等）进行调用，这种情况常见于 app，毕竟网页前端我们可以主动控制发布，只要统一发布后所有人的浏览器下一次访问网页时都会重新加载到最新版的代码，但是像 app 则无法保证用户一定会第一时间升级更新最新版的app，所以往往需要 api接口能够同时保持多个版本的逻辑，同支持新老版本的调用端app进行调用。

针对上面的描述举一个例子：

比如一个创建用户的接口，api/user/createuser

如果我们这个时候对该接口的入参和返回参数修改之后，但是又希望原本的 api/user/createuser 接口逻辑也可以正常运行，常见的做法有以下几种：

1. 修改接口名称，将新的创建用户接口地址定义为 api/user/newcreateuser
2. url传入版本标记，将新的创建用户接口地址定义为 api/user/createuser?api-version=2
3. header传入版本标记，通过校验 header 中的 api-version 字段的值，用来区分调用不同版本的api

第一种方式的缺陷很明显，当接口版本多了之后接口的地址会定义很乱，本文主要讲解后面两种方法，如何在 asp.net webapi 项目中优雅的使用 header 或者 query 传入 版本标记，用来支持api的多个版本逻辑共存，并且扩展 Swagger 来实现 SwaggerUI 对于 api-version 的支持。

截至本文撰写时间，最新的 .net 版本为 .net6 ，本文中的所有示例也是基于 .net 6 来构建的。

首先创建一个 asp.net webapi 项目，本文使用 vs2022 直接创建 asp.net webapi 项目

项目创建好之后安装如下几个nuget包：

Swashbuckle.AspNetCore

Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer

注册 api 版本控制服务

            #region 注册 api 版本控制

 builder.Services.AddApiVersioning(options =>
 {
 //