如何在Quarkus中配置.png文件，适配IDE与部署/原生镜像访问

你的问题根源在于：当应用打包成Jar或原生镜像后，getResource()返回的是归档文件内的资源URL，这类资源不是文件系统中的独立文件，所以用文件系统API（比如Vertx的文件操作）直接访问会报错。而IDE运行时资源是target/classes下的独立文件，所以能正常访问。

以下是适配IDE本地运行、容器部署及原生镜像的通用方案：

1. 优先用输入流读取资源（推荐） #

不管资源是在文件系统还是归档文件中，输入流都能正常读取，这是最通用的方式。

基础读取示例 #

try (InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("image.png")) {
    if (inputStream == null) {
        throw new RuntimeException("未找到资源image.png");
    }
    // 根据需求处理输入流：比如转成图片对象、写入输出流等
    BufferedImage image = ImageIO.read(inputStream);
    // 后续业务逻辑...
} catch (IOException e) {
    throw new RuntimeException("读取资源失败", e);
}

若必须使用文件路径（比如依赖第三方库） #

如果你的场景必须用到文件路径，可以将资源复制到临时文件，临时文件会在应用退出时自动清理：

try (InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("image.png")) {
    if (inputStream == null) {
        throw new RuntimeException("未找到资源image.png");
    }
    // 创建临时文件
    File tempFile = File.createTempFile("temp-image", ".png");
    tempFile.deleteOnExit(); // JVM退出时自动删除临时文件
    // 将资源复制到临时文件
    Files.copy(inputStream, tempFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
    // 现在可以使用tempFile.getAbsolutePath()作为文件路径
} catch (IOException e) {
    throw new RuntimeException("处理资源失败", e);
}

2. 原生镜像环境的额外配置 #

确保原生镜像打包时包含你的PNG资源，在application.properties中添加：

quarkus.native.resources.includes=*.png

不需要将资源移动到META-INF/resources（除非你要把它作为静态Web资源对外暴露），src/main/resources下的资源默认会被打包，配置上述属性后原生镜像会正确包含它们。

3. 作为静态Web资源直接访问 #

如果你的PNG是给前端直接访问的静态资源，将文件放到src/main/resources/META-INF/resources目录下，Quarkus会自动将该目录映射到Web根路径。此时你可以通过http://<你的应用地址>/image.png直接访问，这种方式无需编写代码，适配所有环境。

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