CircleCI 默认 Maven 执行器不包含 JDK 17，导致 mvn clean install 因编译目标版本不匹配而失败；需显式指定 maven/default:17.0 执行器镜像，并确保项目 pom.xml 和 settings.xml 兼容 JDK 17。
circleci 默认 maven 执行器不包含 jdk 17，导致 `mvn clean install` 因编译目标版本不匹配而失败；需显式指定 `maven/default:17.0` 执行器镜像，并确保项目 `pom.xml` 和 `settings.xml` 兼容 jdk 17。
在 CircleCI 中运行 Maven 构建（如 mvn clean install -s settings.xml）时，若项目已声明使用 Java 17（例如
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.10.1:compile (default-compile) on project my-app: Fatal error compiling: error: invalid target release: 17 -> [Help 1]
该错误的根本原因是：CircleCI 的 circleci/maven Orb 默认使用的执行器（executor）基于 cimg/openjdk 镜像，其默认标签（如 latest 或未指定时的 11.0）仅预装 JDK 11 或更早版本，不包含 JDK 17 运行时与编译器。
✅ 正确解决方案是显式指定支持 JDK 17 的执行器镜像。根据 CircleCI Maven Orb 官方文档，maven/default 执行器支持语义化标签，其中 '17.0' 对应预装 OpenJDK 17 的 cimg/openjdk:17.0 镜像。
以下是修正后的 .circleci/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:
jobs:
- maven/test:
executor:
name: maven/default
tag: '17.0'
maven_command: mvn
command: clean install
settings_file: settings.xml
verify_dependencies: false
? 关键说明：
-
executor.name: maven/default表示使用该 Orb 提供的标准 Maven 执行器； -
executor.tag: '17.0'明确拉取cimg/openjdk:17.0镜像（基于 Ubuntu 22.04，预装 OpenJDK 17、Maven 3.9+ 和常用构建工具）； - 无需手动安装 JDK 或配置
JAVA_HOME—— 所有环境变量和 PATH 均由镜像自动设置。
⚠️ 额外注意事项：
- 确保项目
pom.xml中的maven-compiler-plugin版本 ≥ 3.8.1（推荐 3.11.0+），以完整支持 Java 17 语法与模块特性； - 若
settings.xml中启用了远程仓库认证或镜像配置，请确认其与 CircleCI 上下文/环境变量（如MAVEN_USERNAME/MAVEN_PASSWORD）正确集成； - 可通过添加
run步骤快速验证 JDK 版本：- run: java -version && javac -version
完成上述配置后，CircleCI 将在 JDK 17 环境中准确执行 mvn clean install，彻底解决 invalid target release: 17 编译错误，保障构建稳定性与 Java 版本一致性。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
