Android Studio无法解析React Native符号及包问题求助

核心问题分析 #

1. 依赖版本不兼容：@react-native-community/async-storage版本过高，与RN 0.60.4的API不匹配，导致ViewManager等符号无法识别。
2. Node版本过新：RN 0.60.4仅支持Node 10.x/12.x，Node 16.4.0会引发依赖安装和编译的兼容性问题。
3. JDK版本错误：RN 0.60.x不支持JDK 11，必须使用JDK 8，这是符号识别失败的关键原因之一。
4. Android Studio版本与Gradle不匹配：Bumblebee版本对旧版Gradle（5.4.1）和AGP（3.5.1）的支持不佳。

分步解决方案 #

1. 适配@react-native-community/async-storage版本 #

卸载当前高版本库，安装RN 0.60.4兼容的稳定版本：

yarn remove @react-native-community/async-storage
yarn add @react-native-community/async-storage@1.6.2

RN 0.60.x未支持自动链接，需手动执行链接命令：

react-native link @react-native-community/async-storage

2. 降级Node到兼容版本 #

使用nvm切换到RN 0.60.4推荐的Node 12.x版本：

# 若未安装nvm，先安装nvm
nvm install 12.22.12
nvm use 12.22.12

清理旧依赖后重新安装：

rm -rf node_modules yarn.lock
yarn install

3. 调整JDK与Android Studio环境 #

• 切换JDK 8：在Android Studio中打开File > Project Structure > SDK Location，将Gradle JDK改为Java 8（即1.8版本）。
• 更换Android Studio版本：改用Android Studio 4.2.x版本，该版本与AGP 3.5.1、Gradle 5.4.1的兼容性更好。

4. 彻底清理并重新编译 #

执行以下命令清除所有缓存并重建项目：

# 清理RN缓存
watchman watch-del-all
rm -rf $TMPDIR/react-native-packager-cache-*
rm -rf $TMPDIR/metro-bundler-cache-*
# 清理Android项目
cd android
./gradlew clean
cd ..
# 重新编译
react-native run-android

5. 优化build.gradle配置 #

在subprojects块中添加Java版本对齐配置，确保所有子模块使用Java 8编译：

subprojects {
    afterEvaluate { project ->
        if (project.hasProperty("android")) {
            android {
                compileSdkVersion 28
                buildToolsVersion "28.0.3"
                lintOptions {
                    abortOnError false
                }
                compileOptions {
                    sourceCompatibility JavaVersion.VERSION_1_8
                    targetCompatibility JavaVersion.VERSION_1_8
                }
            }
        }
    }
}

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