Spring Boot从Swagger2迁移OpenAPI v3时构建期生成规范的替代方案咨询

核心疑问解答：编译期反射构建OpenAPI规范是否存在技术限制 #

不存在任何根本性的技术限制。早年支持Swagger2的kongchen插件本身就是完全基于编译期类路径反射实现的，全程不需要启动Spring容器。
你遇到的springdoc官方Maven插件要求服务运行的设计，只是产品选型的结果：该插件的实现逻辑是从已经完成初始化的Spring运行时容器中，取出已经解析完成的OpenAPI Bean再导出为文件，并没有自行实现一套独立的类路径扫描逻辑，因此才将执行阶段绑定到集成测试阶段，要求服务处于运行状态——这和反射技术本身的能力边界没有任何关系。

可落地的替代方案 #

• 无缝迁移原构建流程的轻量方案：使用Swagger Core 官方提供的v3版本swagger-maven-plugin
  该插件完全承袭了kongchen插件的设计思路，全程绑定编译/构建阶段执行，不需要启动Spring应用、不需要运行Web容器，通过扫描编译输出目录下的类文件、解析类上的OpenAPI注解、结合SpringMVC的路由元数据，直接生成符合OpenAPI v3规范的yaml/json格式文件作为构建制品，原有kongchen插件的配置项基本可以无缝迁移。
• 深度适配springdoc生态的灵活方案
  如果你已经在项目中大量使用springdoc的注解，不需要绕开springdoc的解析能力：springdoc的核心OpenAPI构建逻辑本身不强制依赖完整的Spring运行时上下文，你可以自行实现一段轻量逻辑，在编译阶段加载类路径元数据、初始化OpenAPI构建器、加载扫描到的Controller类和路由规则，直接序列化输出规范文件，将这段逻辑绑定到Maven的compile阶段执行，完全不需要跑集成测试、不需要启动完整Web容器。
• 复杂场景下的折中方案
  如果项目的路由结构非常复杂、存在大量动态路由、自定义参数解析器等特殊逻辑，纯类路径扫描容易出现信息遗漏，你也可以在CI流程中短暂启动应用、调用springdoc暴露的规范获取接口拉取OpenAPI文件后立刻关停应用，相比官方插件绑定集成测试阶段的实现，这种方式的构建流程更可控，不需要额外依赖测试环境的配置。

内容的提问来源于stack exchange，提问作者Sushant kunal