如何将GitHub下载的Java项目Gradle升级至7.3适配JDK17并解决依赖问题

1. 正确升级Gradle Wrapper #

不要手动修改gradle-wrapper.properties，用官方命令自动完成升级，避免配置遗漏：

./gradlew wrapper --gradle-version 7.3 --distribution-type all

执行后会自动更新wrapper的配置文件和脚本，保证与Gradle 7.3兼容。

2. 配置JDK 17编译与运行环境 #

在项目根目录的build.gradle中更新Java版本配置，Gradle 7+推荐使用枚举形式的版本声明：

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

如果项目中存在gradle.properties，可以添加以下配置强制使用JDK 17：

org.gradle.java.home=/path/to/your/jdk17
org.gradle.jvmargs=--add-opens java.base/java.lang=ALL-UNNAMED

（注：--add-opens仅作为临时兼容方案，优先通过升级依赖解决模块访问问题）

3. 修复依赖兼容性问题 #

排查依赖版本 #

执行以下命令生成依赖树，找出与JDK 17或Gradle 7.3不兼容的库：

./gradlew dependencies

重点关注以下类型的依赖：

• 旧版本测试框架：比如JUnit 4.x需升级到JUnit 5.8+，TestNG需用7.4+版本
• 第三方工具库：比如Apache Commons、Guava等，需升级到支持JDK 17的最新稳定版
• 第三方插件：如果使用了shadow、findbugs等插件，需升级到支持Gradle 7.x的版本（比如Shadow插件需≥7.0.0）

解决依赖冲突 #

如果依赖树中出现版本冲突，可通过强制指定版本或排除冲突依赖处理：

configurations.all {
    resolutionStrategy.force 'com.google.guava:guava:31.1-jre'
}

或针对单个依赖排除冲突：

dependencies {
    implementation('com.example:old-lib:1.0') {
        exclude group: 'com.google.guava', module: 'guava'
    }
}

4. 适配JDK 17的模块限制 #

如果项目使用了Java模块化（存在module-info.java），需确保模块声明兼容JDK 17：

• 移除对已废弃/移除模块的依赖（比如java.xml.bind）
• 针对需要反射访问的包添加opens声明：

module your.module.name {
    opens com.your.package to org.junit.jupiter.api;
}

5. 验证构建与运行 #

完成上述配置后，先执行清理再构建：

./gradlew clean build

如果仍有错误，重点查看日志中的NoClassDefFoundError、IllegalAccessError等异常，定位到具体依赖或代码，针对性升级或修改。

内容的提问来源于stack exchange，提问作者Луцяк Артём Александрович