调试Swashbuckle错误-未能加载API定义

Question

是否有任何方法可以获得堆栈跟踪或Swashbuckle/Swagger错误的内部异常？在某个时候，它停止了工作。我不确定它是否是在我从.NET Core2.0升级到2.1的时候，但我很确定在那之后它仍然有效。当我导航到myapidomain/swagger/index.html时，我得到以下错误：

public void ConfigureServices(IServiceCollection services)
{
    ...
     services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1", new Info
            {
                Version = "v1",
                Title = "My.API",
                Description = "Test"
            });
        });   
}


public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
        app.UseDeveloperExceptionPage();
    else
        app.UseHsts();

    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "PropWorx API V1");
    });
    ...
}

我在ASP.NET Core2.1Web API上使用SwashBuckle.aspNetCore3.0.0。

Answer 1

同意UI调试并不真正有用，但是可以通过打开浏览器的调试工具（例如，Chrome上的F12)，刷新/swaggerendpoint，然后检查swagger.json有效负载来清除完整的异常跟踪--这是一个XHR请求，它将以500状态代码失败。

（对于大型项目，我建议您将链接加入书签，以便以后可以直接转到json文件，例如https://myhost/swagger/v1/swagger.json)

例如，在下面这个人为的错误中，我在两个方法之间复制了相同的路线：

[HttpGet]
[Route("parseenum")]
public ActionResult CheckEnum([FromQuery] MyEnum someEnum)
...

[HttpGet]
[Route("parseenum")]
public ActionResult CheckEnum2([FromQuery] MyEnum someEnum)
...

它会产生错误：

您现在应该能够跟踪并修复它。