Spring springdoc-openapi：swagger-ui/index.html 找不到状态=404

Question

我有一个依赖于 springdoc-openapi 的 spring boot 应用程序（2.5.6）。 但是，启动 swagger-ui (http://localhost:8080/v1/swagger-ui/index.html) 不起作用。 调试日志表明 index.html 不存在。 找不到 index.html 的原因可能是什么？

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

应用程序.yaml

springdoc:
  swagger-ui:
    tagsSorter: alpha
    operations-sorter: alpha
    doc-expansion: none
    disable-swagger-default-url: true

logging:
  level:
    root: DEBUG

server:
  port: 8080

spring:
  application:
    name: fe-applic-app
    api-version: "v1"

Answer 1

尝试swagger-ui.html而不是swagger-ui/index.html 。 在 60% 的情况下， swagger-ui.html会重定向到它的真实位置。

http://localhost:8080/v1/swagger-ui.html http://localhost:8080/v3/swagger-ui.html

Answer 2

我找到了问题的原因。 未在 application.yaml 中设置上下文路径。

http://localhost:8080/ v1 /swagger-ui/index.html

添加servlet : context-path后，渲染 swagger-ui

server:
  port: 8080
  servlet:
    context-path: "/${spring.application.api-version}"