1. 文档背景本文用于总结在 IntelliJ IDEA 中对jaf-java-cloud项目执行 Mavenclean时出现的 POM 解析失败问题并说明 Maven 侧边栏中Profiles、boot3、boot2、jdk-21等配置项的来源、作用、生效位置和推荐配置方式。涉及项目与环境如下项目/工具路径/版本工作目录E:\work2026\workspace后端项目E:\work2026\workspace\jaf-java-cloud公共源码参考E:\work2026\workspace\jnpf-commonJDKD:\Program Files\Java\jdk-21.0.10MavenE:\work2026\dev-tools\maven\apache-maven-3.9.9Maven settingsE:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml本地 Maven 仓库D:\api\maven本次只做问题分析和配置说明未修改项目代码。2. 原始报错现象在 IDEA 中执行 Mavenclean时Maven 命令中包含类似参数-P!boot3随后出现如下典型错误Non-resolvable import POM: The following artifacts could not be resolved: org.seleniumhq.selenium:selenium-bom:pom:${selenium.version}Non-resolvable import POM: The following artifacts could not be resolved: org.springframework.cloud:spring-cloud-dependencies:pom:${spring-cloud.version}Non-resolvable import POM: The following artifacts could not be resolved: com.alibaba.cloud:spring-cloud-alibaba-dependencies:pom:${spring-cloud-alibaba.version}Non-resolvable import POM: The following artifacts could not be resolved: org.springframework.boot:spring-boot-dependencies:pom:${spring-boot.version}同时还出现dependencies.dependency.version for org.springframework.cloud:spring-cloud-starter-bootstrap:jar is missing.dependencies.dependency.version for org.springframework.cloud:spring-cloud-starter-loadbalancer:jar is missing.build.plugins.plugin.version for org.springframework.boot:spring-boot-maven-plugin must be a valid version but is ${spring-boot.version}.这些错误的共同特征是Maven 没有把${spring-boot.version}、${spring-cloud.version}、${spring-cloud-alibaba.version}、${selenium.version}等变量解析成实际版本号而是把它们当成字面量使用。3. 直接结论根因不是 Nexus 仓库中缺少 Spring Boot、Spring Cloud 或 Selenium 的 BOM 文件而是 Maven Profile 没有正确激活。具体原因是当前项目使用 JDK 21。JDK 21 环境下项目需要启用boot3Profile。但 Maven 执行命令中出现了-P !boot3。!boot3的含义是显式禁用boot3Profile。boot3被禁用后Spring Boot、Spring Cloud、Selenium 等关键版本属性没有被定义。Maven 在解析 BOM 依赖时无法替换${...}变量于是把变量文本当成版本号去下载。Nexus 收到带${...}的非法路径后返回400 Invalid repository path。因此核心修复方式是不要禁用boot3而是显式启用boot3。4. Maven Profile 是什么Maven Profile 是 Maven 提供的一种“条件化配置片段”机制。可以把 Profile 理解为一组可开关的 Maven 配置。当某个 Profile 被激活后它里面定义的配置会被合并到 Maven 最终构建模型中也就是合并进 effective POM。Profile 可以包含很多配置例如properties定义版本号、编译参数等属性。dependencies增加或调整依赖。dependencyManagement管理依赖版本。build调整插件、资源、编译配置。repositories配置仓库地址。pluginRepositories配置插件仓库。Profile 的常见用途用途示例按 JDK 切换配置JDK 8 使用boot2JDK 17 使用boot3按环境切换配置dev、test、prod按系统切换配置Windows、Linux、macOS按构建目标切换普通包、Docker 包、发布包按依赖体系切换Spring Boot 2 与 Spring Boot 35. IDEA Maven 侧边栏中的 Profiles 从哪来IDEA Maven 侧边栏中的Profiles不是 IDEA 自己发明的配置而是 IDEA 扫描 Maven 项目和 Maven settings 后展示出来的 Maven Profile。来源主要有三类5.1 来自项目 POM 或父 POMboot3、boot2主要来自项目 POM、父 POM 或本地 Maven 仓库中的父 POM。本次问题中关键父 POM 是D:\api\maven\com\jnpf\jnpf-dependencies\5.2.0-RELEASE\jnpf-dependencies-5.2.0-RELEASE.pom其中定义了profilesprofileidboot3/idactivationjdk[17,)/jdk/activation.../profileprofileidboot2/idactivationjdk(,17)/jdk/activation.../profile/profiles含义如下Profile自动激活条件适用场景boot3JDK 17 及以上Spring Boot 3 / Spring Cloud 2025 体系boot2JDK 小于 17Spring Boot 2 / Spring Cloud 2021 体系当前环境是 JDK 21所以应使用boot3不应使用boot2。5.2 来自 Maven settingsjdk-21来自 Maven settings 文件E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml其中配置了profileidjdk-21/idactivationactiveByDefaulttrue/activeByDefault/activationpropertiesmaven.compiler.source21/maven.compiler.sourcemaven.compiler.target21/maven.compiler.target/properties/profile它的作用是为 Maven 构建提供 Java 编译参数maven.compiler.source21/maven.compiler.sourcemaven.compiler.target21/maven.compiler.target也就是说jdk-21主要控制编译 source/target 级别。5.3 来自用户级 settingsMaven 还会读取用户级 settings%USERPROFILE%\.m2\settings.xml如果其中也定义了 ProfileIDEA Maven 侧边栏中同样可能展示出来。6.boot3的作用boot3是本次问题的关键 Profile。它的核心作用是为 Spring Boot 3 技术栈提供一整套版本属性和依赖管理。在jnpf-dependencies的boot3Profile 中可以看到类似版本定义spring-boot.version3.5.3/spring-boot.versionspring-cloud.version2025.0.0/spring-cloud.versionspring-cloud-alibaba.version2023.0.3.3/spring-cloud-alibaba.versionselenium.version4.21.0/selenium.version这些属性被上方的 BOM import 使用例如dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-dependencies/artifactIdversion${spring-boot.version}/versiontypepom/typescopeimport/scope/dependencydependencygroupIdorg.springframework.cloud/groupIdartifactIdspring-cloud-dependencies/artifactIdversion${spring-cloud.version}/versiontypepom/typescopeimport/scope/dependencydependencygroupIdorg.seleniumhq.selenium/groupIdartifactIdselenium-bom/artifactIdversion${selenium.version}/versiontypepom/typescopeimport/scope/dependency如果boot3不生效上述${...}变量就没有值Maven 就无法正确导入 BOM。7.boot2的作用boot2是另一套 Spring Boot 2 技术栈配置。它一般包含类似版本spring-boot.version2.7.18/spring-boot.versionspring-cloud.version2021.0.9/spring-cloud.versionspring-cloud-alibaba.version2021.0.6.2/spring-cloud-alibaba.versionselenium.version4.13.0/selenium.version它的自动激活条件是jdk(,17)/jdk意思是 JDK 小于 17 时激活。当前环境是 JDK 21因此不应启用boot2。如果同时启用boot2和boot3可能出现属性覆盖、依赖版本冲突、Spring Boot 2/3 混用等问题。8.jdk-21的作用jdk-21来自 Maven settings主要用于设置 Maven 编译参数。它并不是 Spring Boot 3 依赖体系的核心 Profile而是编译环境相关 Profile。作用如下maven.compiler.source21/maven.compiler.sourcemaven.compiler.target21/maven.compiler.target含义属性作用maven.compiler.sourceJava 源码语言级别maven.compiler.target编译输出的 class 目标版本对于当前项目建议勾选jdk-21以保持 IDEA Maven 面板、命令行 Maven 和 JDK 21 环境一致。不过本次报错的直接原因不是jdk-21而是boot3被禁用。9. Profile 在哪里起作用Maven Profile 在 Maven 构建模型阶段生效。执行 Maven 命令时Maven 会先完成以下步骤读取当前项目pom.xml。读取父 POM。读取 Maven settings。计算哪些 Profile 被激活。将激活的 Profile 合并到 Maven 模型中。生成 effective POM。再执行clean、compile、package等生命周期。所以 Profile 会影响IDEA 导入 Maven 项目时的依赖解析。IDEA Maven 侧边栏执行clean、compile、package。命令行执行mvn clean、mvn package。Maven 依赖树。Maven 插件版本。Java 编译参数。子模块依赖版本。BOM import 是否能成功解析。本次即使只是执行cleanMaven 也需要先读取并解析 POM。POM 模型解析失败时clean还没真正开始执行就会失败。10. 为什么clean也会触发依赖解析错误很多人会认为clean只是删除target目录不应该解析依赖。但 Maven 执行任何生命周期之前都需要先构建项目模型。项目模型包括父 POM。dependencyManagement。pluginManagement。properties。profiles。modules。dependencies。如果这些模型无法解析Maven 不知道当前项目是什么结构也不知道插件和依赖版本因此即使执行clean也会失败。本次失败发生在项目模型解析阶段而不是发生在实际清理target目录阶段。11.-P参数的含义Maven 使用-P参数启用或禁用 Profile。11.1 启用 Profilemvn-Pboot3 clean表示启用boot3。启用多个 Profilemvn-Pboot3,jdk-21 clean11.2 禁用 Profilemvn-P!boot3 clean表示禁用boot3。也可能写成mvn-P!boot3 clean在 IDEA 生成的命令中看到-P !boot3就表示 Maven 被要求禁用boot3。这正是本次报错的关键触发点。12. IDEA 中应该如何勾选当前项目使用 JDK 21推荐 IDEA Maven 侧边栏 Profiles 勾选如下Profile是否勾选原因boot3是JDK 21 对应 Spring Boot 3 体系必须启用jdk-21是保持编译参数为 Java 21boot2否JDK 21 不应使用 Spring Boot 2 体系也就是说推荐状态是[ ] boot2 [x] boot3 [x] jdk-21重点检查Maven 执行命令中不能再出现-P !boot313. IDEA 中还需要检查哪些位置除了 Maven 侧边栏中的Profiles还建议检查以下位置。13.1 Maven Run Configuration路径大致是Run/Debug Configurations - Maven - 对应 clean 配置 - Profiles确保其中不是!boot3建议改为boot3,jdk-21或者至少boot313.2 IDEA Maven Runner JDK路径大致是Settings - Build, Execution, Deployment - Build Tools - Maven - Runner - JRE建议选择D:\Program Files\Java\jdk-21.0.10或者选择 Project JDK但 Project JDK 本身应配置为 JDK 21。13.3 IDEA Maven Importing JDK路径大致是Settings - Build, Execution, Deployment - Build Tools - Maven - Importing - JDK for importer建议也使用 JDK 21。13.4 Maven settings 文件确认 IDEA 使用的 settings 是E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml因为jdk-21Profile 定义在这个 settings 文件中。14. 除了 IDEA 侧边栏还可以在哪里配置 Profile14.1 命令行中配置执行 Maven 时直接指定E:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd-Pboot3,jdk-21 clean-f E:\work2026\workspace\jaf-java-cloud\pom.xml带 settings 和本地仓库参数的完整示例E:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd -Pboot3,jdk-21 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven clean -f E:\work2026\workspace\jaf-java-cloud\pom.xml14.2 项目 POM 中配置自动激活在pom.xml中可以通过activation自动激活 Profileprofileidboot3/idactivationjdk[17,)/jdk/activation/profile这表示 JDK 17 及以上自动激活。当前父 POM 中已经有类似配置。14.3 Maven settings 中配置默认激活可以在 settings 中配置activeProfilesactiveProfilejdk-21/activeProfile/activeProfiles或者在具体 profile 中配置activationactiveByDefaulttrue/activeByDefault/activation当前jdk-21就是通过activeByDefault默认激活。14.4 用户级 settings.xml用户级 settings 路径%USERPROFILE%\.m2\settings.xml可以在这里定义和激活个人本地环境相关 Profile。14.5 Maven 安装级 settings.xmlMaven 安装级 settings 路径通常是E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml但你本次使用的是E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml因此实际生效要以-s指定的 settings 文件为准。14.6 项目级.mvn/maven.config项目下可以创建jaf-java-cloud\.mvn\maven.config里面可以写默认 Maven 参数例如-Pboot3,jdk-21 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven不过是否要新增.mvn/maven.config需要团队统一决定因为它会影响所有使用该项目构建的人。本次不建议擅自新增该文件。15. 推荐修复方案15.1 IDEA 中推荐操作打开 IDEA Maven 侧边栏。找到Profiles。勾选boot3。勾选jdk-21。不勾选boot2。检查 Maven Run Configuration 中没有!boot3。重新 Reload Maven Project。再执行 Mavenclean。15.2 命令行推荐操作推荐命令E:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd -Pboot3,jdk-21 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven clean -f E:\work2026\workspace\jaf-java-cloud\pom.xml如果jdk-21已经默认激活也可以只显式指定E:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd -Pboot3 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven clean -f E:\work2026\workspace\jaf-java-cloud\pom.xml16. 验证命令16.1 查看当前激活的 ProfileE:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd -Pboot3,jdk-21 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven help:active-profiles -f E:\work2026\workspace\jaf-java-cloud\pom.xml预期应看到boot3和jdk-21激活不应看到boot2激活。16.2 验证 effective POM 中版本是否解析E:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd -Pboot3,jdk-21 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven help:effective-pom -f E:\work2026\workspace\jaf-java-cloud\pom.xml检查输出中不应再出现${spring-boot.version} ${spring-cloud.version} ${spring-cloud-alibaba.version} ${selenium.version}而应出现实际版本号例如3.5.3 2025.0.0 2023.0.3.3 4.21.016.3 执行 cleanE:\work2026\dev-tools\maven\apache-maven-3.9.9\bin\mvn.cmd -Pboot3,jdk-21 -s E:\work2026\dev-tools\maven\apache-maven-3.9.9\conf\settings.xml -Dmaven.repo.localD:\api\maven clean -f E:\work2026\workspace\jaf-java-cloud\pom.xml本地验证中使用-P!boot3可以复现报错使用-Pboot3后mvn clean可以正常通过。17. 排查思路总结本次排查遵循如下思路先看错误中是否有${...}未解析变量。发现 Maven 正在尝试下载selenium-bom-${selenium.version}.pom这类非法路径。判断不是普通依赖缺失而是 Maven 属性未生效。根据属性名称定位到jnpf-dependencies父 POM。发现这些属性定义在boot3/boot2Profile 中。根据 JDK 21 判断应激活boot3。发现原始命令中存在-P !boot3明确禁用了boot3。使用-P!boot3复现问题。使用-Pboot3验证 clean 成功。得出最终结论IDEA Maven Profile 配置错误导致boot3被禁用。18. 常见误区18.1 误以为是 Nexus 仓库缺包报错中虽然出现了Could not transfer artifact但真正异常的点是版本号仍然是${spring-boot.version}。正常 Maven 下载路径应类似org/springframework/boot/spring-boot-dependencies/3.5.3/spring-boot-dependencies-3.5.3.pom异常路径却是org/springframework/boot/spring-boot-dependencies/${spring-boot.version}/spring-boot-dependencies-${spring-boot.version}.pom所以根因是 Profile 未生效不是仓库缺包。18.2 误以为 clean 不需要解析 POMclean虽然只是生命周期中的清理阶段但 Maven 在执行前仍要读取完整项目模型。POM 模型解析失败时clean会直接失败。18.3 误以为勾选jdk-21就等于启用了boot3jdk-21和boot3是两个不同 Profile。jdk-21主要设置编译 source/target。boot3主要设置 Spring Boot 3 依赖体系版本。jdk-21不能替代boot3。18.4 误以为 IDEA 侧边栏勾选一定覆盖 Run ConfigurationIDEA 中 Maven 侧边栏 Profiles 和具体 Maven Run Configuration 都可能影响最终执行命令。如果 Run Configuration 中写了!boot3仍可能导致执行命令禁用boot3。因此必须检查最终执行命令。19. 最终建议当前项目建议统一采用以下 Maven Profile 组合boot3,jdk-21在 IDEA Maven 侧边栏中[ ] boot2 [x] boot3 [x] jdk-21不要在任何 Maven 命令、Run Configuration、.mvn/maven.config或其他 Maven 参数配置中出现!boot3如果后续团队需要统一构建方式建议在团队层面明确开发 JDK 统一使用 JDK 21。IDEA Maven Runner JDK 统一使用 JDK 21。Maven settings 统一使用settings.xml。Maven Profile 统一启用boot3,jdk-21。不启用boot2。不提交未经确认的.mvn/maven.config避免影响其他开发人员。20. 一句话总结本次 Mavenclean失败的本质原因是 IDEA 执行 Maven 时带了-P !boot3导致 JDK 21 环境下本应启用的boot3Profile 被禁用Spring Boot / Spring Cloud / Selenium 的版本属性没有被解析最终 Maven 使用${...}字面量访问 Nexus 并报400 Invalid repository path。正确做法是在 IDEA Maven Profiles 中勾选boot3和jdk-21不要勾选boot2并确保最终 Maven 命令中不再出现!boot3。