React Native 0.70.x Release模式构建失败求助

常见排查方向及修复步骤 #

1. 检查Android混淆配置（针对Android平台） #

Release模式默认开启代码混淆，第三方库未配置对应规则会触发报错：

• 打开android/app/proguard-rules.pro，添加以下混淆规则：
  • 针对react-native-vector-icons：

    -keep class com.oblador.vectoricons.** { *; }
    -dontwarn com.oblador.vectoricons.**
    

  • 针对react-native-image-picker：

    -keep class com.imagepicker.** { *; }
    -dontwarn com.imagepicker.**
    

  • 针对本地模块rtn-fetch-module：

    -keep class [你的模块包名].rtnfetchmodule.** { *; }
    -dontwarn [你的模块包名].rtnfetchmodule.**
    

  替换[你的模块包名]为本地模块的实际包名。
• 确认android/app/build.gradle的Release配置正确引用规则文件：

  buildTypes {
      release {
          minifyEnabled true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

2. 验证本地模块rtn-fetch-module的Release配置 #

本地模块可能未适配Release构建规则：

• 进入RTNFetchModule目录，检查其build.gradle的Release配置：

  buildTypes {
      release {
          minifyEnabled false // 若模块未配置混淆规则，先关闭避免报错
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

• 执行npx react-native link rtn-fetch-module确认模块已正确链接（0.70版本支持自动链接，手动校验更稳妥）。

3. 修复依赖版本不兼容问题 #

你的metro-react-native-babel-preset版本（0.72.3）与react-native（0.70.6）不匹配，会导致Release构建时编译错误：

npm install metro-react-native-babel-preset@0.70.8 --save-dev

同时可对照React Native官方兼容性文档，校验其他依赖版本是否适配0.70.x。

4. 调整Metro配置适配资源转换 #

因使用react-native-svg-transformer，需确保Metro配置正确处理SVG资源：

const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

module.exports = mergeConfig(getDefaultConfig(__dirname), {
  transformer: {
    babelTransformerPath: require.resolve('react-native-svg-transformer'),
  },
  resolver: {
    assetExts: getDefaultConfig(__dirname).resolver.assetExts.filter(ext => ext !== 'svg'),
    sourceExts: [...getDefaultConfig(__dirname).resolver.sourceExts, 'svg'],
  },
});

5. 清理构建缓存 #

缓存冲突是Release构建失败的常见诱因，执行以下命令清理：

# 清理npm缓存
npm cache clean --force
# 清理React Native缓存
npx react-native clean
# 清理Android构建缓存
cd android && ./gradlew clean && cd ..
# 重新安装依赖
rm -rf node_modules && rm package-lock.json && npm install

6. iOS平台Release构建排查（若涉及iOS） #

• 检查Xcode中Release模式的签名配置，确保开发者证书与描述文件匹配。
• 更新iOS依赖：

  cd ios && pod install --repo-update && cd ..
  

• 确认Info.plist中已添加react-native-image-picker所需的相册、相机权限声明。

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