Swagger Swashbuckle 4.0 版在 swagger 页面顶部引入了一个新的大白条

Version 4.0 of Swagger Swashbuckle introduces a new big white bar at the top of swagger pages

谁能解释一下这个白色条是什么?为什么里面什么都没有?如果里面应该有东西,我该如何添加呢?如果不需要,我该如何摆脱它?在 ASP.NET Core 2.1 WebAPI 中使用 Swashbuckle nuget 包 4.0.1。

这里是 swagger.json 的 link (我不能在这里直接添加它,所以说代码太多)

谢谢

预计到达时间: 因此,在阅读完评论后,有人将我指向一个填写了方案的 swagger 页面。我查看了 JSON 并注意到了这一点:

我的没有这个。我假设这是我的问题。如何使用 swashbuckle 插入此信息?

旁注:如果 Swagger.JSON 中没有此信息...是否应该简单地隐藏该白色条?

因此顶部的大白条用于指定架构。如果您没有明确指定架构,则它是空白的。我已经在 swagger 的 github 回购中提出了一个关于这个的问题。我认为如果这个栏没有用,它应该消失。

要用一些有用的东西填充这个栏,你必须在你的项目中添加这样的东西:

app.UseSwagger(c=>
{
    c.PreSerializeFilters.Add((swagger, httpReq) => swagger.Schemes = new[] { "http", "https" });
});

Swagger UI v. 3.20.1 中的空白条 was fixed。如果定义没有 schemes 且没有 securityDefinitions.

,则会出现白色条

用于添加 schemesPreSerializeFilters 可以同时使用,直到 Swashbuckle 将其捆绑的 Swagger UI 更新为包含该修复程序的版本。