如何在Maven的pom.xml中访问settings.xml中的配置元素

问题根因 #

Maven 3.x 版本中 Profile 激活的文件存在性校验执行在构建初始化的极早期阶段，此时settings相关属性还未加载到属性解析上下文，因此${settings.localRepository}无法被正确替换。该阶段仅支持解析系统属性、环境变量和POM预定义的基础属性。

解决方案 #

方案1：使用${maven.repo.local}属性替换 #

${maven.repo.local}是Maven启动时就会注入的系统属性，直接指向当前生效的本地仓库路径，在Profile激活阶段即可正常解析，完全兼容用户自定义本地仓库的场景，修改配置如下即可：

<profiles>
  <profile>
    <activation>
      <file>
        <exists>${maven.repo.local}/path/to/file</exists>
      </file>
    </activation>
    <!-- 原有profile配置 -->
  </profile>
</profiles>

方案2：添加兜底属性兼容极端场景 #

如果需要兼容部分特殊定制的Maven环境，可以在POM的properties节点添加兜底配置：

<properties>
  <local.repo>${maven.repo.local:-${user.home}/.m2/repository}</local.repo>
</properties>

后续在激活判断中直接引用${local.repo}即可，优先读取maven.repo.local的值，读取失败时自动降级到默认本地仓库路径。

优化建议 #

你现有的两次执行的构建脚本可以简化为单次执行：可以通过maven-install-plugin在initialize阶段直接将内置的第三方依赖包安装到本地仓库，不需要做存在性判断也不会报错，后续依赖解析阶段就能直接读取到对应的依赖，不需要用户执行两次构建命令。

内容的提问来源于stack exchange，提问作者stonar96