问题描述
我正在开发一个 v5.0.6 ASP.NET Core WebApi 并包含启用 SwaggerUI 的 Swashbuckle.AspNetCore Swagger。我正在 Windows 10 版本 21H1(操作系统内部版本 19043.1023)上使用 Visual Studio 2019 v16.10.0 进行开发。项目属性中的设置是:
- IISExpress 应用 URL:http://localhost:64870
- IISExpress 启用 SSL URL:https://localhost:44387/
- 控制台 http://localhost:5000 和 http://localhost:5001
如果我从 VS2019 启动 WebApi 并且它提供 URL 'https://localhost:44387/',则 SwaggerUI 页面完全空白,但可以访问 WebApi 并且可以检索数据 所以我知道 WebApi 正在工作正如它应该。我可以从任何其他 URL 访问 WebApi,并且 SwaggerUI 页面按原样显示。只有“https://localhost:44387/”的 IISExpress SSL URL 具有空页面。我花了几个小时来解决这个问题,但没有解决。
有没有人看到这个问题并有解决方案。
更新:我不得不用一台新的戴尔 8940 台式机替换我的另一台开发机器,所以我安装了所有的开发软件。使用 GitKraken 拉取源代码。启动Visual Studio 2019,打开博客解决方案。之后,我在新机器上使用它相关的 API 开始了博客,并且 SwaggerUI 工作得非常完美。所以其他机器的设置有些特殊。不确定那是什么,但我希望我能弄清楚,因为那台机器是我的主要开发机器。
有人有什么想法吗?
更新:将我的项目更新到 Swashbuckle v6.1.5,一切又恢复正常。 Swagger UI 现在正在按原样加载。嗯嗯....
史蒂夫
解决方法
很难说是什么问题。
尝试添加 nuget 包 Swashbuckle.AspNetCore.SwaggerGen。
在 Startup.cs 'ConfigureServices' 中添加:
services.AddSwaggerGen(options =>
{
options.SwaggerDoc("v1",new Microsoft.OpenApi.Models.OpenApiInfo()
{
Title = "My Api",Version = "1.0"
});
});
并在 Startup.cs 的“配置”中添加:
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json","My Api v1");
});
然后导航到 https://localhost:44387/swagger
检查加载swagger-ui-standalone-preset.js文件是否被杀毒软件阻止。因为没有加载这个文件,所以显示jscript错误如下:
Uncaught ReferenceError: SwaggerUIStandalonePreset is not defined
就我而言,我发现它不仅仅适用于 Microsoft Edge 浏览器。 SSL 适用于 Chrome 和 Firefox。