分布式Gradle项目中如何正确引用Java logging.properties文件路径？

代码中硬编码了开发环境专属的源码相对路径，打包后路径完全失效：

• IDE启动时工作目录默认是项目根目录，./src/main/java/logging/logging.properties这个路径能匹配到源码目录下的文件，所以运行正常
• 执行./gradlew distZip生成的分发包，解压后不存在src/main/java这类源码目录，默认结构如下：
  • 根目录（命名规则为项目名-版本号）
    • bin/：存放Windows bat、Linux/macOS sh启动脚本，脚本启动时默认工作目录为分发包根目录
    • lib/：存放编译生成的项目主jar、所有依赖jar
      启动时找不到配置文件，JUL日志组件就会回退到默认配置，仅向控制台输出日志，不会生成自定义格式的日志文件，同时抛出你看到的路径不存在IO错误。

另外你把配置文件放在src/main/java目录本身不符合Gradle项目规范，资源文件应该放在src/main/resources目录下，编译打包时会自动纳入classpath，不需要手动配置拷贝规则。

1. 调整配置文件存放位置 #

将原路径下的logging.properties移动到src/main/resources/logging/目录下，Gradle编译、打包时会自动将该文件打入项目主jar的classpath路径，IDE运行、打包运行都能访问到。

2. 替换硬编码的文件读取逻辑 #

不要用FileInputStream读取文件系统的固定路径，改为从classpath加载配置，彻底避免路径不匹配问题，修改后的代码如下：

// 从classpath读取日志配置，兼容IDE运行、打包后运行等所有场景
try (InputStream configStream = getClass().getClassLoader()
        .getResourceAsStream("logging/logging.properties")) {
    if (configStream == null) {
        throw new IllegalStateException("日志配置文件logging.properties不存在");
    }
    LogManager.getLogManager().readConfiguration(configStream);
} catch (IOException e) {
    throw new RuntimeException("加载日志配置失败", e);
}

// 日志文件路径建议显式基于工作目录拼接，避免从其他目录启动脚本时日志生成位置错乱
Path logFilePath = Paths.get(System.getProperty("user.dir"), "myLog.log");
FileHandler handler = new FileHandler(logFilePath.toString(), FILE_SIZE, 4, true);
handler.setFormatter(new SimpleFormatter());
logger.addHandler(handler);

注意：优先使用类加载器的getResourceAsStream方法读取资源，不要依赖类实例的getResource方法，避免类加载器层级差异导致资源读取失败。

3.（可选）支持外部修改日志配置 #

如果需要在不重新打包的前提下调整日志配置，可以在build.gradle中给distZip任务增加配置，把配置文件额外拷贝到分发包的独立config目录：

distZip {
    // 将日志配置拷贝到分发包根目录下的config文件夹
    from("src/main/resources/logging") {
        into "config"
    }
}

对应修改配置加载逻辑：优先读取分发包内./config/logging.properties的外部配置，文件不存在时再降级读取classpath内打包的默认配置即可。

之前手动往分发包加文件失效，本质是文件放置的位置和代码里硬编码的读取路径不匹配，或者启动时的工作目录和预期不一致，改用classpath读取的方式完全不依赖文件系统的固定目录结构，只要文件在resources目录下，所有运行场景都能正常加载。

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