React Native 63.5版本AAPT2链接异常问题求助

1. 对齐Android SDK构建工具版本 #

React Native 0.63.x默认适配的Android构建工具版本为29.0.2，你当前使用的4.1.3（对应构建工具30+）版本不匹配会引发AAPT2冲突：

• 打开项目根目录下的android/build.gradle，将buildToolsVersion修改为29.0.2
• 同步调整compileSdkVersion和targetSdkVersion为29，与RN 0.63.x的默认配置保持一致

2. 彻底清理构建缓存 #

除常规清理操作外，需删除深层缓存文件：

• 执行命令：cd android && ./gradlew clean
• 手动删除android/app/build、android/build文件夹
• 删除用户目录下的Gradle缓存：~/.gradle/caches（macOS）或C:\Users\<你的用户名>\.gradle\caches（Windows）

3. 禁用AAPT2增量构建 #

在android/gradle.properties中添加以下配置，强制关闭增量构建以规避守护进程异常：

android.enableAapt2=false

RN 0.63.x支持回退到旧版AAPT，可直接绕过当前链接错误。

4. 排查资源文件隐性错误 #

即使撤销代码修改，资源文件可能存在未被发现的语法问题：

• 检查res/layout、res/drawable下所有XML文件的标签闭合、属性拼写（如android:layout_width是否有误）
• 确保图片资源文件名无特殊字符（空格、中文等），RN对资源文件名格式要求严格

5. 重装依赖并刷新Android构建配置 #

• 删除项目根目录的node_modules、package-lock.json/yarn.lock文件
• 执行npm install或yarn install重装前端依赖
• 进入android目录执行./gradlew build --refresh-dependencies，强制刷新Android依赖

内容的提问来源于stack exchange，提问作者Kamlesh Prajapati