Springdoc OpenAPI Starter for Spring Boot 导致白标错误页面

Question

我有一个带有 Kotlin (1.9.0) 的 Spring Boot (3.1.4) 应用程序和带有基本 REST API 的 Gradle (Kotlin)。我目前正在尝试添加 Springdoc OpenAPI 来记录 REST API，但只收到白标错误页面。 Spring 服务器日志中甚至没有错误消息。

我做了什么

我按照 https://springdoc.org/#kotlin-support 上的指南操作，并将以下行添加到我的依赖项中：

implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.2.0")

我所期待的

我希望在 http://localhost:9876/swagger-ui.html 找到 Swagger UI，如文档中所述 https://springdoc.org/#getting-started。

发生了什么事情

相反，我收到了“白标错误页面”。

Answer 1

一般来说，只需添加

springdoc-openapi-starter-webmvc-ui

依赖项就可以了。但是，如果您发现从 IntelliJ 内部启动 Spring Boot 时出现Whitelabel 错误页面，请尝试以下操作：

• 转到文件 > 使缓存无效...，然后单击使缓存无效并重新启动
• 在终端中，执行

  mvn clean install -DskipTests

• 重新启动您的应用程序
• 尝试访问 http://localhost:8080/[context-root]/v3/api-docs 或 http://localhost:8080/[context-root]/swagger-ui/index.html 这对我有用（经过几个小时的谷歌搜索）...