Asp.Net Core配置Swagger

本文主要参考：Using Swagger with ASP.net Core

1.创建WebApi项目

本文使用ASP.Net Core Web API项目模板演示Swagger到使用，首先创建Web Api项目。

通过Nuget安装Swashbuckle.AspnetCore

也可以通过指令

Install-Package Swashbuckle.AspNetCore

2.Swagger配置

配置ConfigureServices

     public void ConfigureServices(IServiceCollection services)
     {
         services.AddMvc();
         services.AddSwaggerGen(swagger =>
         {
             swagger.SwaggerDoc("v1", new Swashbuckle.AspNetCore.Swagger.Info { Title = "Swagger Demo" });
         });
     }

配置Configure

     public void Configure(IApplicationBuilder app, IHostingEnvironment env)
     {
         app.UseHttpsRedirection();
         app.UseMvc();

         app.UseSwagger();
         app.UseSwaggerUI(c =>
         {
             c.SwaggerEndpoint("/swagger/v1/swagger.json", "Swagger Demo");
         });
     }

配置文件输出

3.运行代码

https://localhost:[port]/swagger/index.html

4.异常

4.1看不到swagger页面

则添加引用 Microsoft.AspNetCore.StaticFiles

4.2Failed to load API definition

解决方法：一定是某个接口没有添加【HttpGet】或者【HttpPost】声明。

参考：https://stackoverflow.com/questions/50209122/swashbuckle-swagger-asp-net-core-failed-to-load-api-definition