Quarkus Native Lambda无法读取资源文件，如何保留resources目录结构？

安全阿岳

2026-7-1

解决Quarkus Java Native Lambda无法读取资源文件的问题

以下是几个排查和解决的关键步骤：

修正资源读取代码
原生镜像中资源并非以文件系统形式存在，不能用File类直接读取路径。必须通过类加载器或Quarkus提供的工具类读取：

// 方式1：使用类加载器
try (InputStream is = getClass().getClassLoader().getResourceAsStream("your/folder/path/file.txt")) {
    if (is != null) {
        // 读取资源内容
    }
} catch (IOException e) {
    // 处理异常
}

// 方式2：使用Quarkus工具类（需导入io.quarkus.runtime.util.Resources）
try (InputStream is = Resources.getResourceAsStream("your/folder/path/file.txt")) {
    // 读取资源内容
} catch (IOException e) {
    // 处理异常
}

调整资源包含配置
quarkus.native.resources.includes=*仅匹配资源根目录下的文件，不会递归包含子文件夹内容。要包含所有层级的资源，改用**：
```
quarkus.native.resources.includes=**
```
若只需包含特定目录，可精确指定，比如：
```
quarkus.native.resources.includes=config/**,templates/**
```
检查路径大小写与编码
Lambda运行环境为Linux，路径区分大小写，确保代码中引用的资源路径与实际文件系统中的路径完全一致（包括大小写）。同时确认资源文件编码在原生模式下能正常读取。
验证资源是否被打包进镜像
构建原生镜像后，可通过以下方式验证资源是否存在：
在Linux环境下执行：
```
strings your-native-lambda-binary | grep "your-resource-path"
```
若能找到资源路径，说明已成功打包；若找不到，需检查Quarkus版本（建议升级到最新稳定版）或打包命令是否正确。