Springdoc Swigger UI未使用Swigger配置

Question

需要springdoc openapi ui的帮助！

我正在使用springdoc-openapi-用户界面来渲染我的API模式。这是它的版本详细信息。

虽然如果我转到localhost:15041/v3/api docs我会得到我的json api文档和localhost:15041/v3/api docs/swagger config，我会得到swagger配置。此外，如果我在petstore页面的浏览搜索区域中输入/v3/api docs，它会显示我的api文档。

我花了超过1.5天的时间来修复它，但它就是不起作用。如果有人能帮忙，真的很感激。

Answer 1

找到问题了。问题在于springdoc库如何使用swagger-用户界面。他们编写了一些自定义代码来修补swagger-用户界面jar动态返回的index.html文件，以在响应中注入config Url查询参数。

现在当swagger-用户界面从4.8.1移动到4.9.0时，他们改变了index.html文件格式，这打破了用springdoc编写的自定义代码。

为了解决这个问题，目前我们需要降级org。webjars:swagger用户界面到4.8.1，其中索引。html文件符合springdoc的预期，springdoc将遵守查询参数中发送的configUrl。

Answer 2

理论上，如果你使用默认的东西，你不应该定义任何选项，我的配置如下所示：

springdoc:
  swagger-ui:
    disable-swagger-default-url: true
    urls[0]:
      name: 'name'
      url: '/v3/api-docs'

有关完整参考和其他有用设置，请参见：https://springdoc.org/#swagger-用户界面属性

你还提到，如果你打电话，它是不起作用的http://localhost:15041/swagger-用户界面。html？configUrl=/v3/api docs/swagger config这是错误的url。正确的是您首先提到的url：http://localhost:15041/swagger-用户界面/索引。html？configUrl=/v3/api docs/swagger config。但是localhost:15041/swagger用户界面。html应该让你的路线正确。

如果使用Spring Security性，还应添加以下依赖项：springdoc openapi安全性

如果它不起作用，我想一定和你的部门有关。