Gradle项目编译报错java.net.http不存在，已装Java17仍异常

云上老周

2026-8-3

解决方案

确认Gradle构建配置的Java版本
打开项目的build.gradle（或build.gradle.kts），明确指定源码和目标兼容性为Java 17：

// Groovy 语法
java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

// Kotlin 语法
java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

也可以在gradle.properties里指定JDK路径：

org.gradle.java.home=/path/to/your/jdk-17

清理缓存并同步Gradle
终端执行命令清理构建缓存并刷新依赖：
```
./gradlew clean build --refresh-dependencies
```
同时清除VS Code的Java语言服务器缓存：按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Java: Clean Java Language Server Workspace，确认后重启VS Code。
配置VS Code的Java运行时
打开VS Code设置（快捷键Ctrl+,/Cmd+,），搜索java.configuration.runtimes，确保将Java 17设为默认运行时：
```
"java.configuration.runtimes": [
    {
        "name": "JavaSE-17",
        "path": "/path/to/your/jdk-17",
        "default": true
    }
]
```
另外检查Extension Pack for Java插件是否为最新版本，旧版本可能存在Java 17支持问题。
模块化项目需声明模块依赖
如果项目使用Java模块系统（存在module-info.java），确保添加对java.net.http模块的依赖：
```
module your.module.name {
    requires java.net.http;
}
```