从SpringFox迁移到SpringDoc后，获得了“为“/v3/api文档”映射的不明确处理程序方法”

Question

使用Spring Boot 2.4.5和IntelliJ 2021.2。迁移后

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

到

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

每次我访问http://localhost:8080/swagger-ui.html。页面上写着：

获取错误未定义/v3/api文档

当我检查日志时：

java.lang.IllegalStateException:为“/v3/api文档”映射的不明确处理程序方法：{public org.springframework.http.ResponseEntity springfox.documentation.oas.web.OpenApiControllerWebMvc.getDocumentation（java.lang.String，javax.servlet.http.HttpServletRequest），public java.lang.String org.springdoc.webmvc.api.OpenApiWebMvcResource.openapiJson（javax.servlet.http.HttpServletRequest，java.lang.String）抛出com.fasterxml.jackson.core。JsonProcessingException}位于org.springframework.web.servlet.handler.AbstractHandlerMethodMapping.lookupHandlerMethod（AbstractHandlerMethodMapping.java:426）位于org.springframework.web.servlet.handler.AbstractHandlerMethodMapping.getHandlerInternal（AbstractHandlerMethodMapping.java:377）位于org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping.getHandlerInternal（RequestMappingInfoHandlerMapping.java:125）位于org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping.getHandlerInternal（RequestMappingInfoHandlerMapping.java:67）位于org.springframework.web.servlet.handler.AbstractHandlerMapping.getHandler（AbstractHandlerMapping.java:498）位于org.springframework.web.servlet.DispatcherServlet.getHandler（DispatcherServlet.java:1257）位于org.springframework.web.servlet.DispatcherServlet.doDispatch（DispatcherServlet.java:1039）位于org.springframework.web.servlet.DispatcherServlet.doService（DispatcherServlet.java:963）位于org.springframework.web.servlet.FrameworkServlet.processRequest（FrameworkServlet.java:1006）位于org.springframework.web.servlet.FrameworkServlet.doGet（FrameworkServlet.java:898）

似乎有一个重复的处理程序方法具有来自SpringFox的相同路径，我如何从SpringFox中删除该方法（它不再存在于我的pom文件中）？

Answer 1

删除swagger依赖项，springfox依赖项。只添加openapi依赖项就足够了。

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

Answer 2

您是否仍然同时具有这两个依赖项？除了webflux，我也有同样的问题。经过一番挖掘，我发现：

• springdoc-openapi-webFlux-core-1.5.10： OpenAPIWebFluxResource.class
• springfox-oas-3.0.0： OpenAPIControlllerWebFlux.class

这两个类都为“/v3/api文档”映射创建处理程序。正如springdoc文档所警告的那样，它们是不兼容的：

https://springdoc.org/#differentiation-to-springfox-project

11.35与Springfox项目的区别

• OAS 3于2017年7月发布，springfox没有发布支持OAS 3的版本。springfox目前只覆盖了与Spring Boot集成的swagger 2。最新发布日期是2018年6月。因此，在维护方面，最近非常缺乏支持

11.36。如何使用springdoc-openapi迁移到OpenAPI 3

• springdoc openapi和springfox之间没有关系。如果您想迁移到OpenAPI 3:

springdoc.swagger-ui.pathswagger-ui.html