You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native发布版APK构建时出现AAPT错误求助

解决React Native构建Release APK时的:app:mergeReleaseResources错误

我帮你排查过这类AAPT2相关的资源合并问题,禁用AAPT2现在其实不太推荐(新版Gradle已经不再支持android.enableAapt2=false这个开关了),咱们换几个更靠谱的方向试试:

  • 检查资源文件命名和格式
    AAPT2对资源的命名规则和格式要求更严格,比如:

    • 资源文件名不能包含大写字母、空格或特殊字符(除了下划线和连字符)
    • 确保所有drawable资源(比如png、svg)没有损坏,xml布局/值文件语法没有错误
    • 检查是否有重复命名的资源(比如不同目录下同名的drawable)
  • 清理并重新构建项目
    先执行以下命令彻底清理缓存:

    cd android
    ./gradlew clean
    cd ..
    npx react-native clean
    

    然后再尝试构建Release APK:

    cd android
    ./gradlew assembleRelease
    
  • 查看详细错误日志定位问题
    直接运行带日志参数的构建命令,能拿到AAPT2报错的具体细节:

    cd android
    ./gradlew assembleRelease --info
    

    日志里会明确指出是哪个资源文件出了问题,比如语法错误、资源重复或者格式损坏,针对性修复即可。

  • 检查依赖库的资源冲突
    有些第三方依赖可能会自带资源,和你的项目资源冲突。可以尝试:

    • 根据日志提示找到冲突的资源,修改项目内的资源名称避免重复
    • 在android/app/build.gradle中给冲突的依赖添加资源排除配置,比如:
      implementation('com.example:conflict-lib:1.0.0') {
          exclude group: 'com.android.support', module: 'support-v4'
      }
      
  • 更新Gradle和构建工具版本
    旧版的Gradle或Android构建工具可能和AAPT2兼容性不好,尝试更新到稳定版本:

    • 在android/build.gradle中更新Gradle插件版本:
      dependencies {
          classpath 'com.android.tools.build:gradle:7.4.2' // 替换为当前稳定版
      }
      
    • 在android/gradle/wrapper/gradle-wrapper.properties中更新Gradle版本:
      distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip // 对应插件版本的Gradle版本
      

如果以上方法都没用,建议你运行./gradlew assembleRelease --stacktrace获取完整的错误堆栈,这样能更精准定位问题所在。

内容的提问来源于stack exchange,提问作者DIGITAL JEDI

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.26 10:25:38