修改build.gradle同步后BuildConfig.VERSION_NAME未更新求助

可能的原因 #

• Gradle 8.x的增量构建优化，导致仅修改版本名称时，依赖BuildConfig的代码未触发重新编译
• Kotlin 2.0的编译缓存机制未感知到BuildConfig的变更
• Android Studio本地缓存与实际生成的BuildConfig字节码不同步

解决办法 #

1. 清理Gradle缓存并重新构建 #

执行命令彻底清理缓存，避免增量构建的缓存干扰：

./gradlew cleanBuildCache clean

完成后重新同步项目，再运行应用。

2. 临时禁用增量构建（针对性排查） #

如果增量构建是问题根源，可在模块的build.gradle（或build.gradle.kts）中临时关闭增量编译：

android {
    compileOptions {
        incremental = false
    }
    kotlinOptions {
        incremental = false
    }
}

注意：禁用后编译时间会增加，问题解决后建议恢复配置。

3. 重置IDE缓存 #

点击Android Studio菜单栏的File -> Invalidate Caches...，选择Invalidate and Restart，重启后重新构建项目。

4. 检查代码中的缓存逻辑 #

如果代码里存在将BuildConfig.VERSION_NAME赋值给静态变量或单例的情况，要确保每次获取的都是最新值，避免初始化时缓存旧版本：

// 错误示例（会缓存旧值）
object AppInfo {
    val VERSION = BuildConfig.VERSION_NAME
}

// 正确示例（每次获取最新值）
object AppInfo {
    val VERSION get() = BuildConfig.VERSION_NAME
}

5. 验证版本名配置是否被覆盖 #

确认build.gradle中版本名的定义未被flavor或buildType覆盖：

android {
    defaultConfig {
        versionName "1.0.1" // 确认此处为最新版本名
    }
    // 检查productFlavors或buildTypes是否重写了versionName
    productFlavors {
        dev {
            // 若此处定义versionName，会覆盖defaultConfig的值
        }
    }
}

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