React Native执行./gradlew clean bundle时依赖配置解析失败求助

问题定位 #

你遇到的问题核心是：添加android.applicationVariants相关代码后，Gradle 8.7的严格变体匹配机制无法在react-native-firebase_messaging模块的多个debug变体中找到属性完全匹配的版本，导致依赖解析失败。

解决方案 #

1. 排查applicationVariants自定义代码 #

先检查你添加的android.applicationVariants逻辑，是否无意中给debug变体添加了额外属性或修改了默认配置。比如以下错误写法会破坏变体属性一致性：

android {
    applicationVariants.all { variant ->
        if (variant.buildType.name == 'debug') {
            // 错误示例：添加了自定义属性，导致与依赖模块属性不匹配
            variant.compileConfiguration.attributes.attribute(
                Attribute.of("customAttribute", String), "debug-only-value"
            )
        }
    }
}

如果有这类代码，先注释掉，重新执行./gradlew clean bundleDebug测试是否恢复正常。

2. 强制对齐依赖变体属性 #

在app模块的build.gradle中添加变体匹配规则，强制让react-native-firebase_messaging的debug变体与你的app模块属性对齐：

configurations.all {
    resolutionStrategy {
        // 针对react-native-firebase相关模块，强制匹配核心属性
        matchingVariants { variant ->
            variant.with {
                attributes {
                    // 对齐Android目标环境属性
                    attribute(
                        TargetJvmEnvironment.TARGET_JVM_ENVIRONMENT_ATTRIBUTE,
                        TargetJvmEnvironment.ANDROID
                    )
                    // 对齐打包属性（如果有差异）
                    attribute(
                        BundlingAttrs.BUNDLING,
                        BundlingAttrs.EXTERNAL
                    )
                }
            }
        }
    }
}

3. 升级react-native-firebase_messaging版本 #

旧版本的react-native-firebase_messaging可能未适配Gradle 8.x的变体匹配规则。将依赖升级到最新兼容版本：
在package.json中更新依赖：

"@react-native-firebase/messaging": "^20.0.0"

执行npm install或yarn install后，重新执行构建命令。

4. 清理Gradle缓存并刷新依赖 #

缓存异常也可能导致变体匹配失败，执行以下命令彻底清理并重新同步：

./gradlew clean
rm -rf ~/.gradle/caches
./gradlew bundleDebug --refresh-dependencies

进一步排查 #

如果以上步骤无效，查看错误日志中具体的属性不匹配项（比如minSdkVersion、targetSdkVersion或自定义属性差异），针对性调整app模块的对应属性，确保与react-native-firebase_messaging的debug变体完全一致。

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