如何使用springdoc-openapi-webflux-UI显示应用程序API文档？

Question

我阅读了https://springdoc.github.io/springdoc-openapi-demos/文档，以使用springdoc-openapi-webflux-UI。正如文档所说，我刚刚向我的应用程序添加了springdoc-openapi-webflux-ui库:实现('org.springdoc:springdoc-openapi-webflux-ui:1.2.26')

此外，我在application.yml中定制了API的路径：

springdoc:
  swagger-ui:
    path: /swagger-ui.html

当我启动应用程序并转到http://localhost:8080/swagger-ui.html时，它会将我重定向到http://localhost:8080/webjars/swagger-ui/index.html？configurl=/v3/api-docs/swagger-config。在那一页中，我得到了一个错误：

Whitelabel Error Page
This application has no configured error view, so you are seeing this as a fallback.
Mon Jan 20 05:16:10 UTC 2020
[7192d9dc] There was an unexpected error (type=Not Found, status=404).
No matching handler

问题是：我是否应该向我的应用程序添加额外的配置来显示API文档？

Answer 1

默认情况下，您只需要添加springdoc-openapi-webflux-UI的依赖项。

 <dependency>
      <groupId>org.springdoc</groupId>
      <artifactId>springdoc-openapi-webflux-ui</artifactId>
      <version>1.2.32</version>
   </dependency>

您可以查看演示代码：

• https://github.com/springdoc/springdoc-openapi-demos.git-

null

正如Spring Boot参考文档中所述，当您使用@enableWebFlux时，您告诉Spring Boot您希望完全控制WebFlux配置，并为此禁用所有自动配置（包括静态资源）：

• https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-webflux-auto-configuration

您有两种解决方案：

null

这里已经讨论过了：

• https://github.com/springdoc/springdoc-openapi/issues/402