如何从OpenAPI资源文件手动初始化Swagger（Kotlin Spring Boot MVC）

你可以通过两种方式直接加载本地的openapi.yml文件作为Swagger UI的数据源，不需要依赖转发配置：

方法一：自定义OpenAPI Bean加载YAML文件 #

通过编写配置类，手动读取openapi.yml并转换为OpenAPI对象，让SpringDoc直接使用这个对象生成Swagger文档：

1. 确保openapi.yml放在src/main/resources目录下
2. 创建Kotlin配置类：

import io.swagger.v3.oas.models.OpenAPI
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.core.io.ResourceLoader
import org.yaml.snakeyaml.Yaml
import java.io.InputStreamReader

@Configuration
class OpenApiConfig {

    @Bean
    fun customOpenAPI(resourceLoader: ResourceLoader): OpenAPI {
        val openApiResource = resourceLoader.getResource("classpath:openapi.yml")
        return Yaml().loadAs(InputStreamReader(openApiResource.inputStream), OpenAPI::class.java)
    }
}

如果需要对加载后的OpenAPI对象做自定义调整（比如添加全局安全方案、修改文档标题），可以在返回前直接修改该对象。

方法二：通过SpringDoc配置属性指定文件路径 #

直接在application.yml或application.properties中配置SpringDoc的属性，让它自动加载本地的YAML文件：

springdoc:
  openapi:
    # 指定本地openapi文件的路径
    location: classpath:openapi.yml
  # 若只想展示本地文件的内容，关闭自动扫描项目中的接口
  packages-to-scan: none
  paths-to-match: none

注意事项 #

• 确保你的openapi.yml符合**OpenAPI 3.0+**规范，SpringDoc基于OpenAPI 3.x，不兼容Swagger 2.0的格式
• 如果同时保留自动接口扫描和本地文件加载，SpringDoc会自动合并两者的API定义；若只想展示本地文件内容，务必关闭packages-to-scan和paths-to-match

内容的提问来源于stack exchange，提问作者darth jemico