在K8s环境中使用OpenApiParser解析OpenAPI 3.0.0规范文件失败

问题背景 #

Spring Boot项目中，资源文件夹存放OpenAPI 3.0.0的YAML文件，本地IntelliJ运行时，通过以下方式构建URL并解析正常：

URL url = Resources.getResource("MyFile.yaml"); // com.google.common.io
OpenApi3 openApi3 = (OpenApi3) new OpenApiParser().parse(url);

但部署到K8s环境后，URL变为jar:file:some_image_name.jar!/BOOT-INF/lib/my_folder-0.1.0-beta.0.149+20220910T185040Z-plain.jar!/MyFile.yaml，解析失败。尝试this.getClass().getResource("/MyFile.yaml")和this.getClass().getClassLoader().getResource("MyFile.yaml")得到相同URL，仍无法解析。

原因分析 #

OpenApiParser的parse(URL)方法对嵌套Jar（Spring Boot fat jar内的依赖Jar）中的资源URL支持不佳，这类jar:file:协议的URL无法被当作普通文件路径处理，导致解析失败。本地环境中资源是直接的文件系统路径（file:/协议），所以能正常读取。

解决方案 #

改为通过InputStream读取资源，再传递给OpenApiParser解析，避免直接依赖URL的文件系统访问能力。

代码示例 #

// 方式1：使用Class.getResourceAsStream
try (InputStream inputStream = this.getClass().getResourceAsStream("/MyFile.yaml")) {
    if (inputStream == null) {
        throw new IllegalArgumentException("MyFile.yaml not found in resources");
    }
    // 若YAML存在相对引用，传入资源所在基础路径；无引用可传null/空字符串
    String basePath = this.getClass().getResource("/").toString();
    OpenApi3 openApi3 = (OpenApi3) new OpenApiParser().parse(inputStream, basePath, new OpenApiParser.Configuration());
} catch (IOException e) {
    e.printStackTrace();
}

// 方式2：使用Guava的Resources工具类
try (InputStream inputStream = Resources.getResource("MyFile.yaml").openStream()) {
    String basePath = Resources.getResource("MyFile.yaml").getPath();
    OpenApi3 openApi3 = (OpenApi3) new OpenApiParser().parse(inputStream, basePath, new OpenApiParser.Configuration());
} catch (IOException e) {
    e.printStackTrace();
}

关键说明 #

• getResourceAsStream可直接读取Jar内资源，不受外部路径格式限制
• 用try-with-resources语法确保InputStream自动关闭，避免资源泄漏
• basePath参数用于处理YAML中的相对引用，无相关需求可省略（传入null）

内容的提问来源于stack exchange，提问作者V John