Gradle buildSrc中Properties类未初始化问题求助

核心原因 #

• 类初始化失败而非未编译：报错Could not initialize class Properties本质不是类没编译，而是自定义Properties单例在初始化myProps时抛出了未捕获异常（比如找不到配置文件），导致类加载流程中断，Gradle会将这种情况判定为“类不存在”。
• 相对路径不可靠：你用File("myProps.properties")加载文件，依赖于Gradle构建时的当前工作目录，但buildSrc编译阶段和模块构建阶段的工作目录可能不一致，新机器上Gradle的启动目录也未必是项目根目录，直接导致文件找不到。
• 类名冲突：自定义类名Properties和JDK内置的java.util.Properties完全重名，会引发类加载歧义，进一步加剧初始化失败的问题。

解决方案 #

1. 修复配置文件加载方式（优先解决路径问题）

将myProps.properties移动到buildSrc/src/main/resources目录（没有就创建），改用类加载器读取资源，彻底摆脱工作目录的限制：

import java.util.Properties

// 重命名类避免与JDK类冲突
object ProjectProperties {

    val myProps: Properties by lazy {
        val props = Properties()
        // 通过类加载器读取resources下的配置文件
        ProjectProperties::class.java.classLoader.getResourceAsStream("myProps.properties")?.use { inputStream ->
            props.load(inputStream)
        } ?: throw IllegalStateException("myProps.properties not found in buildSrc resources")
        props
    }
}

用lazy延迟初始化可以让错误信息更明确，避免类加载阶段就抛出模糊异常。

2. 更新模块构建脚本的引用

把模块build.gradle.kts里的引用改成新的类名：

android {
    buildTypes {
        getByName("release") {
            buildConfigField("String", "SOME_PROP", ProjectProperties.myProps.getProperty("MY_PROP"))
            // ... 其他配置
        }
    }
}

3. 优化buildSrc配置（可选）

移除已废弃的jcenter()仓库，并升级Kotlin版本以匹配AGP版本（AGP 7.0.3建议搭配Kotlin 1.5.31及以上）：

plugins {
    `kotlin-dsl`
    `kotlin-dsl-precompiled-script-plugins`
    java
}

repositories {
    google()
    mavenCentral()
}

dependencies {
    implementation("com.android.tools.build:gradle:7.0.3")
    implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:1.5.31")
}

4. 清理缓存（新机器首次修复后执行）

执行命令清理Gradle缓存，确保旧的编译产物被完全移除：

./gradlew clean build --no-build-cache

验证步骤 #

1. 确认myProps.properties已放在buildSrc/src/main/resources目录
2. 替换自定义类的代码与类名
3. 更新所有模块构建脚本中的引用
4. 执行清理命令后重新构建

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