Docker容器内SpringBoot读取Jar外YAML文件时targetStream返回null

问题根源 #

你当前代码用System.getProperty("user.dir")拼接文件路径，但Docker容器中执行java -jar app/test.jar时，默认工作目录是容器根目录/而非/app。这导致拼接出的路径是/config/keys.yaml，但实际文件在/app/config/keys.yaml，因此找不到文件，最终流对象为null（大概率是未捕获文件不存在的IOException导致）。

修复方案 #

方案1：直接使用绝对路径（最简单） #

既然容器内目录结构固定，直接写死绝对路径即可：

String filePath = "/app/config/keys.yaml";
LOGGER.info("file Path " + filePath);
File initialFile = new File(filePath);

// 提前校验文件存在性，快速定位问题
if (!initialFile.exists()) {
    LOGGER.error("配置文件不存在: {}", filePath);
    throw new RuntimeException("缺少必要配置文件：keys.yaml");
}

try (InputStream targetStream = Files.newInputStream(initialFile.toPath())) {
    Yaml yaml = new Yaml();
    HashMap<String,String> yamlMap = yaml.load(targetStream);
    // 处理配置内容
} catch (IOException e) {
    LOGGER.error("读取配置文件失败", e);
    throw new RuntimeException("加载配置文件出错", e);
}

方案2：设置容器工作目录（适配原有代码） #

修改Dockerfile，添加WORKDIR /app将容器启动后的工作目录切换到/app，这样System.getProperty("user.dir")会返回/app，原有路径拼接逻辑就能正常工作：

#pull base image
FROM java:8-jre

# 设置工作目录为/app
WORKDIR /app

COPY target/test.jar .

EXPOSE 80 3306

ENTRYPOINT ["java","-jar", "test.jar"]

方案3：用SpringBoot原生外部配置机制（推荐） #

SpringBoot本身支持加载外部配置文件，无需自己写读取逻辑。可以通过启动参数指定额外配置文件路径：

# 修改ENTRYPOINT添加配置参数
ENTRYPOINT ["java","-jar", "test.jar", "--spring.config.additional-location=/app/config/keys.yaml"]

之后直接通过@Value或@ConfigurationProperties注入配置值：

@Component
public class ConfigReader {
    @Value("${your.key.name}")
    private String yourKey;

    // 使用配置值
}

或者用配置类批量绑定：

@ConfigurationProperties(prefix = "app")
@Component
public class AppConfig {
    private String apiKey;
    private String secret;

    // getter、setter
}

这种方式更符合SpringBoot生态，还能自动处理配置刷新、类型转换等问题。

额外排查建议 #

1. 进入容器执行ls /app/config确认文件是否存在，同时检查文件权限（确保容器进程有读权限）。
2. 打印System.getProperty("user.dir")的实际值，验证工作目录是否符合预期。

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