OpenAPI 和 spring-doc 未找到控制器类中的所有映射

这有点奇怪。 springdoc-openapi-ui v1.2.32，生成的文档仅包含控制器内的一些映射。

Example:

    @Operation(
            summary = "Foo",
            description = "Foo"
    )
    @PostMapping(path="/v1/foo")
    public ResponseEntity<ResponseObject> postFoo(@RequestBody FooRequestObject searchRequest, HttpServletRequest request){ ... }


    @Operation(
            summary = "Bar",
            description = "Bar"
    )
    @GetMapping(path="/v1")
    public ResponseEntity<ResponseObject> getBar(@RequestBody BarRequestObject request, HttpServletRequest request){ ... }


    @Operation(
            summary = "Bar",
            description = "Bar"
    )
    @PostMapping(path="/v1")
    public ResponseEntity<ResponseObject> postBar(@RequestBody BarRequestObject request, HttpServletRequest request){ ... }

仅生成文档postBar and getBar服务，其他路径被忽略。

我尝试过的：

1. 最初这两个 POST 方法都被命名为post。我重命名是为了避免冲突。
2. 我没有设置控制器级别路径。
3. 检查注释导入
4. 未命中文档的缓存版本

如果我向控制器添加另一个服务（带或不带注释标记），它也不会显示在生成的 Swagger 中。例如：

@GetMapping(path="/test")
public String getTest(){
    return "test";
}

如果我将此方法添加到全新的控制器中，则会生成文档。

Thanks

Edit配置类

@Configuration
public class SwaggerConfig {                                    

    @Bean
    public OpenAPI springOpenAPI() {
        return new OpenAPI()
                .info(new Info().title("My API")
                .description("My API service documentation. ")
                .version("v1.0")
                .license(new License().name("Terms of Use").url("https://myapi.com/terms.html")));
    }
    
}

您面临的问题是由于您使用了 1 级参考文献而引起的paths-to-match这导致 Springdoc 过滤可用的端点only在指定的路径上。

springdoc.paths-to-match=/api/v1,/v2,/v3,/status

上述属性与端点进行匹配开始和结束 with /v2, /v3, /status, /api/v1。这无法匹配可能具有以下形式的端点/users/v2/甚至/v2/users etc.

虽然不支持完整的正则表达式来指定您想要包含的端点，但有基本支持**这可以帮助您指定要包含/排除的级别。

考虑下面的例子

springdoc.paths-to-match=/**/v1/**/

它将包括具有以下特征的任何端点/v1/在里面。例子如/users/v1/, /v1/dasboard并且/user/v1/dashboard.

springdoc.paths-to-match=/v2/**

它将仅匹配以以下开头的端点/v2并深入 n 层。例子如/v2/dashboard将被包括在内，但是/users/v2/something将被排除在外。

springdoc.paths-to-match=/**/v1

它只会匹配以以下结尾的路径/v1。例子如/users/v1将被匹配，而那些喜欢/v1/user将不会被匹配。

或者，您也可以更新您的Bean做同样的事情。但请注意，属性文件优先于 bean 配置。

// you existing bean here

// Define an API group that'll include specific version. Can be helpful in versioning the APIs.
@Bean
public GroupedOpenApi hideApis() {
    return GroupedOpenApi.builder().group("default")
            .pathsToExclude("/api/v2/**", "/v2/**", "/**/v3/**")
            .pathsToMatch("/v1/**", "/api/v1/**")
            .build();
}