无法更改swagger UI路径

Question

我正在使用Swagger为Spring boot2微服务创建API留档，我是Swagger的新手。我的Spring启动应用程序具有上下文路径 /api/user/因此该应用程序可在localhost:8080/api/user访问。swagger默认用户界面可在/swagger-ui.html访问。所以从我的项目来看，网址是localhost:8080/api/user/swagger-ui.html/但我出错了

Failed to convert value of type 'java.lang.String' to required type 'java.lang.Long'; nested exception is java.lang.NumberFormatException: For input string: "swagger-ui.html"

因为有apilocalhost:8080/api/user/{id}。我无法更改微服务的联系路径。请建议如何将自定义路径添加到swagger用户界面，以便swagger用户界面可以在urllocalhost:8080/api/user/swagger/swagger-ui.html或localhosr： 8080/swagger/swagger-ui.html.以下是我的配置文件

@Configuration
public class SwaggerConfiguration{

    //...

    
      @Bean
      public Docket api(ServletContext servletContext) {
        return new Docket(DocumentationType.SWAGGER_2)
            .securitySchemes(Arrays.asList(apiKey()))
            .securityContexts(Collections.singletonList(securityContext()));
      }

      private SecurityContext securityContext() {
        return SecurityContext.builder().securityReferences(defaultAuth()).forPaths(PathSelectors.regex("/.*")).build();
      }

      private List<SecurityReference> defaultAuth() {
        final AuthorizationScope authorizationScope = new AuthorizationScope("global", "accessEverything");
        final AuthorizationScope[] authorizationScopes = new AuthorizationScope[]{authorizationScope};
        return Collections.singletonList(new SecurityReference("Bearer", authorizationScopes));
      }

      private ApiKey apiKey() {
        return new ApiKey("Bearer", "Authorization", "header");
      }
      
} 

Answer 1

您点击了错误的URL。

Swagger UI位于：

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

如果需要配置路径，可以在应用程序中更改路径。yml（示例）：

springdoc:
  swagger-ui:
    path: /documentation/swagger-ui-my-project.html

如果需要更多信息，请提供带招摇过市设置的教程：https://dzone.com/articles/spring-boot-swagger-3-openapi-3-security-exampleba