本文详解如何在 CircleCI 中正确配置 JDK 17 运行时环境，解决 maven-compiler-plugin 因目标版本不匹配（如 error: invalid target release: 17）导致的构建失败问题。
本文详解如何在 circleci 中正确配置 jdk 17 运行时环境，解决 `maven-compiler-plugin` 因目标版本不匹配（如 `error: invalid target release: 17`）导致的构建失败问题。
在 CircleCI 中执行 mvn clean install 时出现 invalid target release: 17 错误，根本原因并非 Maven 命令本身有误，而是默认执行器（executor）未提供 JDK 17 支持——CircleCI 的 circleci/maven orb 默认使用较旧的 OpenJDK 版本（如 JDK 11 或 8），而你的 pom.xml 或 maven-compiler-plugin 配置中指定了 <release>17></release> 或 <target>17</target>，导致编译器无法识别该版本。
✅ 正确解决方案是显式指定支持 JDK 17 的 executor。circleci/maven orb 底层基于 cimg/openjdk 官方镜像，该镜像已预装多个 JDK 版本标签（tag），其中 17.0、17.0.2、17-alpine 等均可直接使用。
以下是推荐的 config.yml 配置（已优化可读性与健壮性）：
version: 2.1
orbs:
maven: circleci/maven@4.6.0 # 建议固定版本号，避免意外升级
slack: circleci/slack@4.15.2
docker: circleci/docker@3.9.0
workflows:
maven-build:
jobs:
- maven/test:
executor:
name: maven/default
tag: '17.0' # ✅ 关键：启用 JDK 17 运行时
maven_command: mvn
command: clean install
settings_file: settings.xml
verify_dependencies: false
# 可选：添加 Java 版本验证步骤（便于调试）
steps:
- run: java -version
- run: javac -version
? 注意事项与最佳实践：
- ✅ 始终固定 orb 版本号（如
@4.6.0），避免因 orb 升级引入兼容性问题； - ✅
tag: '17.0'对应cimg/openjdk:17.0镜像，完整可用标签列表见 CircleCI OpenJDK 镜像文档； - ⚠️ 若项目依赖 Jakarta EE 9+ 或新特性（如
sealed类、switch表达式增强），还需确保maven-compiler-plugin在pom.xml中明确声明 JDK 17：
<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><source>17</source><target>17</target><release>17</release><!-- 推荐：启用跨版本兼容编译 --></configuration></plugin>
- ? 构建失败时，可通过
steps中添加java -version和mvn -v快速验证运行时环境是否生效； - ? 若需构建多 JDK 版本（如兼容测试），可借助 workflow matrix 或定义多个 job 并分别指定
tag: '11'/'17'/'21'。
通过以上配置，CircleCI 将使用预装 JDK 17 的容器执行 Maven 构建，彻底解决 invalid target release: 17 编译错误，保障 CI 流程与本地开发环境一致、可靠、可复现。
