小编Vin*_*umo的帖子

SpringDoc openAPI 工具未扫描 Spring Boot 项目中的 API

我无法让它发挥作用。我已经从一个工作的 SpringBoot (v2.2.2) 应用程序和一个工作的 @RestController 开始。为了让 springdoc 工作,我在我的 pom 中包含了以下依赖项:

\n\n
 <dependency>\n  <groupId>org.springdoc</groupId>\n  <artifactId>springdoc-openapi-ui</artifactId>\n  <version>1.2.28</version>\n</dependency>\n
Run Code Online (Sandbox Code Playgroud)\n\n

然后我构建并开始了我的服务。然后我浏览到 api-docs 端点,得到:

\n\n
{"openapi":"3.0.1","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost:8081","description":"Generated server url"}],"paths":{},"components":{}}\n
Run Code Online (Sandbox Code Playgroud)\n\n

我是不是少了一步?我假设在运行时它会扫描我的代码,找到 @RestController,找到 @RequestMapping 方法并从中生成 api。

\n\n

作为第二次尝试,我决定使用 swagger @Operation 注释来注释我的方法之一,但仍然没有被拾取。

\n\n

最后,我尝试使用 springdoc.packagesToScan 手动指定控制器的包,但这也不起作用。

\n\n

这感觉就像 springdoc 没有看到我的控制器..即使 spring 看到了..它完全活跃并且可以工作..

\n\n

不知道我错过了什么..

\n\n

这是我的项目依赖项:

\n\n
[INFO] +- org.springframework.boot:spring-boot-starter-web:jar:2.2.2.RELEASE:compile\n[INFO] |  +- org.springframework.boot:spring-boot-starter:jar:2.2.2.RELEASE:compile\n[INFO] |  |  +- org.springframework.boot:spring-boot:jar:2.2.2.RELEASE:compile\n[INFO] |  |  +- org.springframework.boot:spring-boot-autoconfigure:jar:2.2.2.RELEASE:compile\n[INFO] |  |  +- org.springframework.boot:spring-boot-starter-logging:jar:2.2.2.RELEASE:compile\n[INFO] |  |  |  +- ch.qos.logback:logback-classic:jar:1.2.3:compile\n[INFO] |  |  |  |  \\- ch.qos.logback:logback-core:jar:1.2.3:compile\n[INFO] | …
Run Code Online (Sandbox Code Playgroud)

swagger swagger-ui spring-boot openapi springdoc

19
推荐指数
3
解决办法
5万
查看次数

标签 统计

openapi ×1

spring-boot ×1

springdoc ×1

swagger ×1

swagger-ui ×1