使用 WebAPI .Net Core 进行版本控制无法按预期工作

Question

我正在尝试将 URL 版本控制引入到我的 .Net Core WebAPI 应用程序中。我还使用 Swagger Web 工具以方便用户使用。

现在，在尝试将版本控制引入我的应用程序时，我在这里引用了文档：https : //github.com/Microsoft/aspnet-api-versioning/wiki/New-Services-Quick-Start#aspnet-core

现在，我对我的代码进行了以下代码更改：

Startup.cs/ConfigureServices 我在下面添加了代码：

services.AddApiVersioning(options => {
                    options.AssumeDefaultVersionWhenUnspecified = true;
                });

现在，在添加任何类型的版本控制之前，我的控制器注释如下所示：

    [Produces("application/json")]
    [Route("api/controllerName")]

并生成一个如下所示的 URL：

http://localhost:12003/swagger/#!/Workspace/GetAll

现在，我在下面添加了注释以启用 api 版本控制：

. [ApiVersion("1.0")] [Produces("application/json")] [Route("api/v{version:apiVersion}/workspace")]

现在当我点击我的 swagger UI 中列出的相同方法时

网址如下所示：

http://localhost:12003/swagger/#!/controllername/ApiV_versionGetAll

虽然我期待的是这样的：

http://localhost:12003/swagger/#!/controllername/V1.0/GetAll

同样在我的招摇中，它现在明确要求我输入版本号。所以我认为我的问题归结为两个要点：

Answer 1

您缺少的是支持 API 版本感知 API Explorer 的 API 版本控制的补充包：

Install-Package Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer

API Explorer 是 Swagger 生成器（如 Swashbuckle）完成所有工作的方式。API 版本控制库中也提供了源代码和链接。

为了达到你想要的结果，你需要在 URL 中配置 API 版本替换：

services.AddMvcCore().AddVersionedApiExplorer( options => options.SubstituteApiVersionInUrl = true );

注：该呼叫AddMvcCore()在API版本不再需要3.0+

官方 API 版本控制库中提供了文档和示例。我建议查看API 文档wiki 主题：

接受的答案扩展了这个包，只要它与您正在使用的 API 版本控制的风格保持同步就可以了。API 版本控制总是在每个版本上提供兼容的 API Explorer 扩展。