swagger-ui - Swagger UI 中无法读取文件问题

Question

我已将 swagger-ui 合并到我的应用程序中。

当我尝试查看 swagger-ui 时，我很好地获得了 API 文档，但一段时间后，它在按钮上显示了一些错误图标。

错误信息如下:

[{"level":"error","message":"Can't read from file http://MYIP/swagger/docs/v1"}]

我不确定是什么原因造成的。如果我刷新它，它就会工作并在几秒钟后显示错误。

Answer 1

我猜测“http://MYIP/swagger/docs/v1 ”不可公开访问。

默认情况下，swagger ui 使用在线验证器:online.swagger.io。如果它无法访问您的 swagger url，那么您将看到该错误消息。

可能的解决方案:

1. 禁用验证:

   config.EnableSwagger().EnableSwaggerUi(c => c.DisableValidator());

2. 让您的网站可供公开访问

3. 在本地托管验证器:

您可以从以下位置获取验证器:https://github.com/swagger-api/validator-badge#running-locally

您还需要告诉 swaggerui 验证器的位置

config.EnableSwagger().EnableSwaggerUi(c => c.SetValidatorUrl(<validator_url>));