Java开发环境配置专题：JDK、IDEA、Maven、Gradle、版本兼容与常见报错

本专题整理 Java 开发环境配置相关教程，包括 JDK 镜像下载、IDEA 配置本地 JDK、Maven 国内镜像、Gradle 国内镜像、Java 版本兼容、class major version 对照表，以及常见环境报错解决方法。

如果你正在搭建 Java 开发环境，或者遇到 JDK 下载慢、IDEA 下载 JDK 卡住、Maven 依赖下载失败、Gradle 同步很慢、JDK 版本不兼容等问题，可以按下面顺序阅读。

Java 项目启动失败，很多时候并不是代码问题，而是环境没有配置好。

常见问题包括：

JDK 下载慢
IDEA 下载 JDK 卡住
JAVA_HOME 配置错误
Maven 依赖下载失败
Gradle 插件下载失败
Unsupported class file major version
java: invalid source release
No compiler is provided in this environment

这个专题会持续更新，目标是把 Java 开发中最常见的环境配置问题整理成一套可查、可复制、可排错的实用教程。

一、推荐阅读顺序

如果你是第一次配置 Java 开发环境，建议按下面顺序阅读：

  1. 各版本JDK镜像下载地址：先下载合适的 JDK
  2. IDEA下载JDK很慢怎么办？手动配置本地JDK完整教程
  3. Maven国内镜像settings.xml配置大全：解决 Maven 依赖下载慢
  4. Gradle国内镜像配置教程：解决 Gradle 插件、依赖和 Wrapper 下载慢
  5. Java版本号与class文件major version对照表：解决 JDK 版本不兼容
  6. JDK8与JDK11的区别：了解老项目常见 JDK 版本差异

二、JDK 下载与版本选择

1. 各版本 JDK 镜像下载地址

如果你在国内下载 JDK 速度慢，可以先看这篇：

各版本JDK镜像下载地址：JDK8 / JDK11 / JDK17 / JDK21 / JDK25 / JDK26 下载与IDEA配置指南

这篇文章整理了常用 JDK 下载入口，包括：

Eclipse Temurin
OpenJDK
Oracle JDK
Alibaba Dragonwell
Tencent Kona
华为毕昇 JDK
GraalVM
Liberica JDK

适合解决：

JDK 下载慢
Oracle JDK 下载麻烦
国内 JDK 镜像地址
JDK8 / JDK11 / JDK17 / JDK21 下载
JDK25 / JDK26 下载

2. JDK8 与 JDK11 有什么区别？

如果你维护的是老项目，或者正在考虑从 JDK8 升级到 JDK11，可以看这篇：

JDK8与JDK11的区别

这篇适合解决：

JDK8 和 JDK11 有什么区别
老项目要不要从 JDK8 升级到 JDK11
JDK11 新增了哪些特性
JDK8 升级 JDK11 要注意什么

3. JDK8、JDK11、JDK17、JDK21、JDK25 怎么选？

计划更新：

JDK8、JDK11、JDK17、JDK21、JDK25怎么选？Java项目版本选择指南

这篇后续会重点解决：

老项目应该继续用 JDK8 吗？
新项目应该选 JDK17 还是 JDK21？
JDK25 是否值得升级？
Spring Boot 2 / 3 / 4 分别适合哪个 JDK？
生产环境能不能直接用最新版 JDK？

三、IDEA 配置 JDK

IDEA 下载 JDK 很慢怎么办？

如果 IDEA 中的 Download JDK 下载很慢，或者项目提示没有配置 JDK，可以看这篇：

IDEA下载JDK很慢怎么办？手动配置本地JDK完整教程

这篇文章主要解决：

IDEA 下载 JDK 卡住
Add JDK from disk 怎么选目录
Project SDK 怎么配置
Module SDK 怎么配置
Maven Runner JRE 怎么配置
Gradle JVM 怎么配置
IDEA 里为什么还是旧 JDK

常见报错包括：

Project SDK is not defined
No JDK specified
java: invalid source release: 17
Unsupported class file major version 65
No compiler is provided in this environment

四、Maven 国内镜像配置

Maven 国内镜像 settings.xml 配置大全

如果 Maven 下载依赖很慢，或者经常出现 Could not transfer artifact，可以看这篇：

Maven国内镜像settings.xml配置大全：阿里云、腾讯云、华为云、清华源

这篇文章主要解决：

Maven 依赖下载慢
settings.xml 放在哪里
阿里云 Maven 镜像怎么配
腾讯云 Maven 镜像怎么配
华为云 Maven 镜像怎么配
IDEA 中 Maven settings.xml 怎么指定
Maven 本地仓库 localRepository 怎么配置

常见报错包括：

Could not transfer artifact
Could not resolve dependencies
Transfer failed for https://repo.maven.apache.org
PKIX path building failed
No compiler is provided in this environment

五、Gradle 国内镜像配置

Gradle 国内镜像配置教程

如果 Gradle 同步很慢，或者 Android Studio / IDEA 一直卡在下载 Gradle，可以看这篇：

Gradle国内镜像配置教程：init.gradle、repositories与Wrapper加速完整指南

这篇文章主要解决：

Gradle 下载慢
Gradle Wrapper 下载慢
Gradle 插件下载失败
repositories 怎么配置
pluginManagement 怎么配置
init.gradle 怎么配置
settings.gradle 怎么配置

常见报错包括：

Downloading Gradle distribution...
Plugin was not found in any of the following sources
Could not resolve all files for configuration
Could not GET https://plugins.gradle.org/
Could not GET https://repo.maven.apache.org/maven2/

六、Java 版本兼容与报错排查

Java 版本号与 class major version 对照表

如果你遇到 Unsupported class file major version，可以先看这篇：

Java版本号与class文件major version对照表：Unsupported class file major version 52 / 55 / 61 / 65 / 69 / 70

常见对应关系：

class major version对应 Java 版本
52Java 8
55Java 11
61Java 17
65Java 21
69Java 25
70Java 26

这篇文章主要解决：

Unsupported class file major version 65 是什么问题？
major version 61 是 JDK 几？
JDK17 为什么跑不了 JDK21 编译的项目？
Maven 项目怎么设置编译版本？
Gradle 项目怎么设置 Java Toolchain？
IDEA 里怎么检查 JDK 配置？

七、Java 工具与学习资源

Java 开发者必备工具箱

如果你想收藏一些 Java 开发常用网站、官方文档、依赖查询工具、在线工具，可以看这篇：

Java开发者必备工具箱

这篇适合补充：

Oracle Java 文档
Spring 官方文档
MyBatis-Plus 文档
Maven 依赖查询
JSON 格式化
在线 Java 编译器
Java 技术资讯站点

Java 学习路线

如果你是初学者，或者想系统梳理 Java 学习路径，可以看这篇：

Java学习路线

这篇适合解决：

Java 从哪里开始学
Java 入门到进阶怎么安排
Maven / Gradle 应该什么时候学
Spring Boot 和 MyBatis 应该怎么衔接
Java 后端开发需要掌握哪些内容

八、Spring Boot 与 Java 生态延伸阅读

Spring Boot 开发注意事项

如果你已经完成 JDK、Maven、Gradle 环境配置，准备进入 Spring Boot 开发，可以看这篇：

Spring Boot框架在开发过程中应注意的关键事项

这篇适合了解：

Spring Boot 自动配置
配置文件管理
依赖管理
日志配置
异常处理
生产环境注意事项

Spring Boot 的诞生与发展

如果你想了解 Spring Boot 为什么会出现，以及它在 Java 企业开发中的定位，可以看这篇：

Spring Boot 的诞生与发展

MyBatis、MyBatis Plus 与 tk-mybatis 的技术选型指南

如果你正在做 Java 后端项目，需要选择 ORM / 数据访问框架，可以看这篇：

MyBatis、MyBatis Plus 与 tk-mybatis 的技术选型指南

静态获取Bean与依赖注入的全方位对比分析

如果你在 Spring 项目中纠结 SpringUtil.getBean() 和依赖注入的区别，可以看这篇：

静态获取Bean与依赖注入的全方位对比分析

九、计划更新的环境配置文章

下面这些文章会陆续补齐：

Windows安装JDK 8 / 17 / 21 / 25完整教程：JAVA_HOME环境变量配置与验证

macOS安装与切换多个JDK教程：Homebrew、SDKMAN!、JAVA_HOME配置

Linux安装JDK与切换多版本Java教程：Ubuntu / CentOS / Debian / Rocky Linux

Spring Boot与JDK版本兼容表：Spring Boot 2.x / 3.x / 4.x应该用哪个Java版本？

OpenJDK、Oracle JDK、Temurin、Corretto、Dragonwell、Kona、毕昇JDK有什么区别？

Java Docker镜像怎么选：openjdk、eclipse-temurin、amazoncorretto、dragonwell区别

十、计划更新的常见报错文章

下面这些报错会继续整理成独立文章：

Maven Could not transfer artifact 下载失败解决：settings.xml、国内镜像、本地缓存与代理排查

Gradle Plugin was not found 解决办法：pluginManagement、repositories和国内镜像配置

No compiler is provided in this environment 解决：JDK和JRE区别

java: invalid source release 17 / 21 解决办法：IDEA、Maven、Gradle配置排查

source option 5 is no longer supported 解决办法：Maven编译版本配置

PKIX path building failed 解决：Maven / Gradle 下载依赖证书错误排查

Spring Boot启动报错 Failed to configure a DataSource 解决办法

MyBatis Invalid bound statement not found 解决办法：Mapper XML、namespace、扫描路径完整排查

注意：这些计划文章暂时不要加 # 空链接。等文章发布后，再回来补真实链接。

十一、常见问题

1. 为什么 Java 项目经常是环境问题？

因为 Java 项目通常同时依赖：

JDK
IDEA
Maven
Gradle
Spring Boot
第三方依赖
CI/CD
Docker
服务器运行环境

只要其中一个地方版本不一致，就可能出现编译失败、运行失败、依赖下载失败等问题。

2. 新项目应该用哪个 JDK？

一般建议：

普通新项目：JDK17 或 JDK21
长期维护项目：优先 JDK21，评估 JDK25
老项目：按项目要求使用 JDK8 或 JDK11
尝鲜测试：可以使用 JDK26

如果团队没有明确要求，不建议盲目使用最新非 LTS 版本。

3. Maven 和 Gradle 都需要配置国内镜像吗？

如果你在国内开发，建议配置。

Maven 常见配置文件是：

~/.m2/settings.xml

Gradle 常见配置位置是：

settings.gradle
settings.gradle.kts
~/.gradle/init.gradle
gradle/wrapper/gradle-wrapper.properties

Maven 和 Gradle 的镜像配置方式不一样，不要混用。

4. IDEA 配置了 JDK，为什么命令行还是旧版本？

因为 IDEA 使用的是项目内配置，命令行使用的是系统环境变量。

需要分别检查：

IDEA Project SDK
IDEA Module SDK
Maven Runner JRE
Gradle JVM
JAVA_HOME
PATH

5. Unsupported class file major version 怎么解决？

先根据 major version 判断对应 JDK：

52 = Java 8
55 = Java 11
61 = Java 17
65 = Java 21
69 = Java 25
70 = Java 26

然后选择：

升级运行环境 JDK
或者降低项目编译版本

可以直接查看：

Java版本号与class文件major version对照表

十二、建议收藏本专题

如果你经常开发 Java 项目，可以收藏这个专题。后续会持续补充：

JDK 下载地址
JDK 版本选择
IDEA 配置教程
Maven 镜像配置
Gradle 镜像配置
Spring Boot 版本兼容
Java 常见环境报错
Docker Java 镜像选择
CI/CD Java 环境配置

目标是把 Java 开发中最常见的环境问题整理成一个长期可用的资料入口。

更新记录

2026-05-20：
- 创建 Java开发环境配置专题
- 增加 JDK 镜像下载入口
- 增加 IDEA 配置 JDK 教程入口
- 增加 Maven 国内镜像配置入口
- 增加 Gradle 国内镜像配置入口
- 增加 Java major version 对照表入口
- 增加 JDK8 与 JDK11 对比文章入口
- 增加 Java学习路线、Java开发者工具箱、Spring Boot、MyBatis 等延伸阅读入口