React Native中执行./gradlew bundleRelease失败，无法构建APK

开发者阿泽

2026-8-18

React Native 执行 ./gradlew bundleRelease 构建失败解决方案

从错误截图来看，核心问题是**:app:mergeReleaseResources 任务执行失败**，伴随Android资源链接错误，以下是针对性解决步骤：

清理构建缓存
彻底清除项目缓存与构建文件，重新初始化依赖：

cd android
./gradlew clean
rm -rf .gradle app/build
cd ..
rm -rf node_modules
npm install

检查资源文件名与路径
Android对资源文件名、路径大小写敏感，确保res目录下无大小写重复的文件（如同时存在Icon.png和icon.png），文件夹路径也需保持大小写一致。
排查重复资源依赖
查看项目依赖树定位重复资源来源：
```
cd android
./gradlew app:dependencies
```
找到重复资源的依赖后，在android/app/build.gradle中用exclude排除重复部分，示例：
```
implementation('com.example:library:1.0') {
    exclude group: 'com.android.support', module: 'support-v4'
}
```

对齐SDK与Gradle版本
确保android/build.gradle和android/app/build.gradle中的SDK版本、buildToolsVersion与本地安装的Android SDK匹配，示例配置：

// android/build.gradle
buildscript {
    ext {
        buildToolsVersion = "33.0.0"
        minSdkVersion = 21
        compileSdkVersion = 33
        targetSdkVersion = 33
    }
}