Android Studio调试模式运行仍使用Release签名配置问题排查

我来帮你排查这个头疼的问题——明明点了调试按钮，却触发了Release版本的签名校验，导致找不到指定的keystore文件。咱们一步步来解决：

1. 先确认运行配置的变体是否选错 #

很多时候是不小心把运行目标设成了Release变体，才会触发Release的签名流程。你可以这样检查：

• 点击Android Studio顶部的「Run/Debug Configurations」下拉框（就是显示当前运行目标的地方）
• 选择你的React Native应用配置，查看「Build variant」选项是否为Debug，如果是Release的话改成Debug即可

2. 检查android/app/build.gradle的签名配置 #

这是最可能出问题的核心区域，重点核对signingConfigs和buildTypes两个区块：

正确的配置示例 #

android {
    // ...其他配置内容

    signingConfigs {
        // Release版本签名配置（调试时不会用到，除非主动指定）
        release {
            storeFile file("my-release-key.keystore")
            storePassword "your-release-password"
            keyAlias "your-release-key-alias"
            keyPassword "your-release-key-password"
        }
        // Debug版本签名配置（Android Studio默认会自动生成，也可手动指定）
        debug {
            storeFile file('debug.keystore') // 默认路径是~/.android/debug.keystore
            storePassword 'android'
            keyAlias 'androiddebugkey'
            keyPassword 'android'
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release // Release版本关联Release签名
            minifyEnabled enableProguardInReleaseBuilds
            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
        }
        debug {
            signingConfig signingConfigs.debug // 重点！Debug版本必须关联Debug签名，不能写成release
            minifyEnabled false
            debuggable true
        }
    }
}

常见错误点 #

• buildTypes.debug里的signingConfig被错误设置成了signingConfigs.release，导致调试时也会去读取Release的keystore
• 没有配置debug签名块，但Android Studio默认的debug keystore路径被修改过，导致找不到（这种情况相对少见）

3. 清理项目缓存并重建 #

如果配置没问题但还是报错，大概率是gradle缓存搞的鬼：

• 点击Android Studio顶部菜单「Build」→「Clean Project」
• 然后点击「Build」→「Rebuild Project」
• 之后再尝试启动调试

临时应急方案（不推荐长期使用） #

如果你暂时不需要配置Release签名，可以先把signingConfigs.release和buildTypes.release里的signingConfig配置注释掉，这样调试时就不会触发Release的签名校验了。不过后续打包Release版本时记得恢复配置。

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