Springdoc无法显示Maven依赖中导入的@RestController问题

算力阿峰

2026-7-30

解决Springdoc无法识别依赖包中Flowable Rest Controller的问题

针对你遇到的Springdoc无法展示Flowable依赖中ProcessInstanceCollectionResource控制器的问题，可以尝试以下几种解决方案：

1. 确认Spring容器已加载目标控制器

Flowable的Rest控制器需要通过特定配置启用，检查你的启动类是否添加了@EnableFlowableRest注解，确保ProcessInstanceCollectionResource已被Spring容器实例化。如果Bean未被Spring管理，Springdoc无法读取其接口元数据。

2. 精准配置Springdoc的扫描规则

配置路径匹配：Flowable Rest接口默认前缀为/process-api，通过springdoc.paths-to-match指定要扫描的路径，覆盖默认规则：
```
springdoc.paths-to-match=/process-api/**,/your-custom-api/**
```
修正包扫描路径：ProcessInstanceCollectionResource的完整包路径是org.flowable.rest.service.api.runtime.process，确保springdoc.packages-to-scan包含该路径：
```
springdoc.packages-to-scan=com.your.custom.package,org.flowable.rest.service.api.runtime.process
```

3. 通过配置类手动注册控制器

之前的静态代码块可能因初始化时机问题失效，改用Spring配置类的方式注册：

@Configuration
public class SpringDocCustomConfig {
    static {
        // 手动添加目标控制器到Springdoc的扫描列表
        SpringDocUtils.getConfig().addRestControllers(ProcessInstanceCollectionResource.class);
    }

    // 或者分组注册Flowable的API文档
    @Bean
    public GroupedOpenApi flowableProcessApi() {
        return GroupedOpenApi.builder()
                .group("flowable-process-management")
                .packagesToScan("org.flowable.rest.service.api.runtime.process")
                .build();
    }
}