ASP.NET核心-Swashbuckle不创建swagger.json文件

Question

我很难让swashbuckle.aspnetcore(1.0.0)包生成任何输出。我读到swagger.json文件应该写到'~/swagger/docs/v1'。然而，我没有得到任何输出。

我从一个全新的ASP.NET核心API项目开始。我应该提到这是ASP.NET Core2。API可以工作，我可以从values控制器检索值。

我的启动类的配置与本文描述的完全相同（GitHub上的swashbuckle.aspnetcore）。

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddMvc();

        services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1", new Info { Title = "My API", Version = "v1" });
        });
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();

            // Enable middleware to serve generated Swagger as a JSON endpoint.
            app.UseSwagger();
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "MyAPI V1");
            });
        }
        else
        {
            app.UseExceptionHandler();
        }

        app.UseStatusCodePages();
        app.UseMvc();

        //throw new Exception();
    }
}

[Route("api/[controller]")]
public class ValuesController : Controller
{
    // GET api/values
    [HttpGet]
    public IEnumerable<string> Get()
    {
        return new string[] { "value1", "value2" };
    }

    // GET api/values/5
    [HttpGet("{id}")]
    public string Get(int id)
    {
        return "value";
    }

    // POST api/values
    [HttpPost]
    public void Post([FromBody]string value)
    {
    }

    // PUT api/values/5
    [HttpPut("{id}")]
    public void Put(int id, [FromBody]string value)
    {
    }

    // DELETE api/values/5
    [HttpDelete("{id}")]
    public void Delete(int id)
    {
    }
}

Answer 1

我也有同样的问题。请查看http://localhost:xxxx/swagger/v1/swagger.json。如果您得到任何错误，修复它们。

例如，我在一个基本控制器类中有一个不明确的路由，我得到的错误是：“Action的不明确HTTP方法。Actions要求为Swagger2.0提供显式的HttpMethod绑定。”如果使用基本控制器，请确保公共方法使用httpget/httppost/httpput/httpdelete或Route属性，以避免路由不明确。

然后，我还在同一个方法中html" target="_blank">定义了HttpGet（“Route”）和Route（“Route”）属性，这是Swagger的最后一个问题。