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