Gradle非测试环境下无法设置环境变量或系统属性的问题排查

方案1：编译时生成配置文件 #

在Gradle中添加任务，编译前生成包含项目目录的配置文件到resources目录，Java代码直接读取该文件即可获取路径。

Gradle配置：

task generateProjectDirConfig {
    def configFile = file("src/main/resources/project-config.properties")
    outputs.file(configFile)
    doLast {
        configFile.text = "project.dir=${projectDir}"
    }
}

// 让编译任务依赖配置文件生成任务
tasks.withType(JavaCompile) {
    dependsOn generateProjectDirConfig
}

Java代码读取示例：

import java.io.IOException;
import java.util.Properties;

public class ProjectDirUtil {
    public static String getProjectDir() {
        Properties props = new Properties();
        try {
            props.load(ProjectDirUtil.class.getClassLoader().getResourceAsStream("project-config.properties"));
            return props.getProperty("project.dir");
        } catch (IOException e) {
            e.printStackTrace();
            return null;
        }
    }
}

方案2：编译时生成常量类 #

通过Gradle生成包含项目目录常量的Java类，编译进项目后，Java代码直接引用该常量即可。

Gradle配置：

task generateProjectDirConstant {
    def constantFile = file("src/main/java/com/your/package/ProjectConstants.java")
    outputs.file(constantFile)
    doLast {
        constantFile.parentFile.mkdirs()
        constantFile.text = """
package com.your.package;

public class ProjectConstants {
    public static final String PROJECT_DIR = "${projectDir}";
}
"""
    }
}

tasks.withType(JavaCompile) {
    dependsOn generateProjectDirConstant
}

Java代码引用示例：

String projectDir = ProjectConstants.PROJECT_DIR;

方案3：启动时传递JVM参数（适合部署场景） #

如果服务通过脚本启动，直接在启动命令中添加JVM参数：

java -DPROJECT_DIR=/path/to/your/project -jar your-service.jar

若使用Gradle的application插件打包服务，可在插件配置中预设JVM参数，打包后的启动脚本会自动包含该参数：

plugins {
    id 'application'
}

application {
    applicationDefaultJvmArgs = ["-DPROJECT_DIR=${projectDir}"]
}

Java代码通过System.getProperty("PROJECT_DIR")即可获取路径。

之前方案失效的原因 #

• test块配置的环境变量仅作用于测试任务（如./gradlew test），不会影响主代码的运行环境。
• Exec任务必须指定要执行的命令（如commandLine），你之前的配置缺少执行命令导致报错；且Exec任务的环境变量仅对自身执行的命令有效，无法传递到Java程序的运行环境。
• Exec任务没有systemProperty方法，该方法属于JavaExec任务，因此会触发找不到方法的报错。

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