Flutter Android本地debug构建仍调用release签名配置是什么原因？

问题根源 #

Gradle执行构建时分为配置阶段和执行阶段，配置阶段会解析build.gradle里所有的顶层配置代码，和你最终选择的构建变体（debug/release）无关。你当前的release签名配置直接读取环境变量并创建file对象，本地没有配置对应环境变量时，配置阶段就会直接抛出路径为空的错误，并不是构建过程真的调用了release的签名配置，只是配置阶段提前执行了release签名的代码导致报错。

解决方案 #

修改release签名配置逻辑，增加环境变量存在的判断，只有对应环境变量存在时才初始化release签名配置：

signingConfigs {
    debug {
        def keystorePropertiesFile = rootProject.file("keystore.properties")
        def keystoreProperties = new Properties()
        keystoreProperties.load(new FileInputStream(keystorePropertiesFile))

        storeFile file(keystoreProperties['storeFile'])
        storePassword keystoreProperties['storePassword']
        keyAlias keystoreProperties['keyAlias']
        keyPassword keystoreProperties['keyPassword']
   }

   release {
       // 增加环境变量判空逻辑，避免本地无环境变量时配置阶段报错
       def storeFileEnv = System.getenv("STORE_FILE")
       if (storeFileEnv != null && storeFileEnv.isNotEmpty()) {
           storeFile = file(storeFileEnv)
           storePassword System.getenv("STORE_PASSWORD")
           keyAlias System.getenv("KEY_ALIAS")
           keyPassword System.getenv("KEY_PASSWORD")
       }
   }
}

buildTypes {
    debug {
        signingConfig signingConfigs.debug
    }
    release {
        minifyEnabled true
        shrinkResources true
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        // 同样增加判断，只有release签名配置存在时才使用，否则走默认逻辑
        if (signingConfigs.release.storeFile != null) {
            signingConfig signingConfigs.release
        }
    }
}

额外验证点 #

• 确认本地项目根目录存在keystore.properties文件，且里面的storeFile路径配置正确，避免debug签名配置报错
• CI环境中确保已经配置了STORE_FILE、STORE_PASSWORD、KEY_ALIAS、KEY_PASSWORD四个环境变量，不影响正式发版的签名逻辑

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