React Native构建APK失败：compileSdkVersion配置问题求助

错误信息整理 #

FAILURE: 构建过程中出现异常，构建失败。

问题原因：
无法确定任务':react-native-pdf-lib:bundleLibRuntimeToJarRelease'的依赖项。
> 无法创建任务':react-native-pdf-lib:compileReleaseJavaWithJavac'。
> 要编译Java 9+源码，请将compileSdkVersion设置为30或更高版本

构建失败，耗时3分12秒
构建过程中使用了已弃用的Gradle特性，与Gradle 9.0不兼容。

你修改了android/app/build.gradle的compileSdkVersion为30但问题仍存在，核心原因是第三方库react-native-pdf-lib自身的模块配置未使用30+的compileSdkVersion，而非你的App模块配置问题。

解决方法 #

方法1：全局统一Android编译配置（推荐） #

在项目根目录的android/build.gradle中定义全局编译版本变量，让所有模块（包括第三方库）自动继承：

1. 打开android/build.gradle，找到buildscript -> ext块，添加/修改配置：

buildscript {
    ext {
        buildToolsVersion = "34.0.0"
        minSdkVersion = 21
        compileSdkVersion = 33 // 设置为30或更高版本
        targetSdkVersion = 33
    }
    // 保留原有其他配置
}

2. 确保android/app/build.gradle引用全局变量而非硬编码版本：

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
    defaultConfig {
        targetSdkVersion rootProject.ext.targetSdkVersion
        // 保留原有其他配置
    }
}

方法2：用patch-package修改react-native-pdf-lib的配置 #

若全局配置不生效，说明库本身硬编码了compileSdkVersion，可通过补丁工具修改：

1. 打开node_modules/react-native-pdf-lib/android/build.gradle，将compileSdkVersion改为30或更高：

android {
    compileSdkVersion 33
    // 保留原有其他配置
}

2. 安装patch-package：

npm install patch-package --save-dev

3. 生成补丁文件：

npx patch-package react-native-pdf-lib

后续执行npm install时，补丁会自动应用到该库。

方法3：升级react-native-pdf-lib到最新版本 #

检查该库最新版本是否已修复编译版本问题，执行升级命令：

npm install react-native-pdf-lib@latest

最后：清理构建缓存 #

修改配置后清理旧缓存避免残留：

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

内容的提问来源于stack exchange，提问作者Chethaka Lakshitha