统一JDK版本需“源头约束+构建强制+团队协同”：在README.md等文档明确标注最低（如JDK 17）及推荐版本（如JDK 17.0.2 LTS），禁用不兼容特性；Maven通过maven.compiler.source/target和enforcer-plugin校验Java版本。
在Java项目中统一JDK版本，核心是“源头约束 + 构建强制 + 团队协同”，不能只靠口头约定或开发人员自觉。
明确项目所需的JDK版本并写入文档
在项目根目录的README.md或CONTRIBUTING.md中清晰标注最低支持版本（如 JDK 17）和推荐版本（如 JDK 17.0.2 LTS），同时说明不兼容的特性（例如：禁止使用 JDK 21 的虚拟线程，除非已升级全部依赖）。避免模糊表述如“JDK 17+”，要具体到小版本或明确LTS要求。
通过构建工具强制约束JDK版本
Maven 和 Gradle 都支持编译与运行时的JDK校验，这是最有效的技术兜底手段：
-
Maven：在pom.xml中配置
<maven.compiler.source></maven.compiler.source>和<maven.compiler.target></maven.compiler.target>为17，并添加maven-enforcer-plugin插件检查Java版本：<requirejavaversion><version>[17.0.2,18)</version></requirejavaversion> -
Gradle：在build.gradle中设置
java.toolchain.version = "17"，并启用java { requireJdkVersion("17.0.2") }（需Gradle 8.4+）；老版本可用org.gradle.java.home环境变量结合CI脚本做校验。
利用IDE和本地开发环境同步配置
开发人员本地IDE若未对齐，会导致“本地能跑、CI失败”。建议：
立即学习“Java免费学习笔记（深入）”；
- 在项目根目录提供.idea/jdk.table.xml（IntelliJ）或.settings/org.eclipse.jdt.core.prefs（Eclipse）模板，锁定JDK路径和语言级别；
- 使用sdkman!或jenv管理多版本JDK，并在项目根目录放置.sdkmanrc或.java-version文件，执行
sdk use或jenv local 17.0.2即可一键切换； - 将JDK版本检查脚本（如
java -version | grep "17.0.2"）加入pre-commit hook或./scripts/check-jdk.sh，便于快速发现不一致。
CI/CD流水线中固化JDK环境
持续集成是统一版本的最后防线。必须在CI配置中显式声明JDK，而非依赖系统默认：
- GitHub Actions：用
actions/setup-java@v4指定java-version: '17'和distribution: 'temurin'； - Jenkins：在Pipeline中使用
tool 'jdk-17.0.2-temurin'（需提前在全局工具配置中注册）； - GitLab CI：通过
image: registry.gitlab.com/temurin/jdk17:jre或variables: JAVA_HOME: /opt/java/openjdk确保环境纯净。
