Maven资源插件无法解析project.parent.basedir问题求助

问题重现 #

在Spring Boot Maven模块中执行mvn resource:resource或mvn install -DskipTests时，出现以下差异现象：

• ${project.basedir}、${project.build.directory}、${project.parent.artifactId}等内置属性均可正常解析
• 仅${project.parent.basedir}无法被解析，会以原字符串形式保留在最终生成的application.yml中

相关配置 #

pom.xml中的属性定义：

<properties>
    <project.plugins-properties-location>${project.basedir}/src/main/conf/plugins-properties.yml</project.plugins-properties-location>
    <project.osgi-directory-path>${project.build.directory}/osgi</project.osgi-directory-path>
    <project.persona-project-path>${project.parent.basedir}/sample/dataset</project.persona-project-path>
</properties>

application.yml中的属性引用：

application:
  osgi-directory-path: "@project.osgi-directory-path@"
  plugins-properties-location: "@project.plugins-properties-location@"
  dataset-properties:
    persona-project-path: "@project.persona-project-path@"

执行结果 #

最终生成的application.yml中，仅persona-project-path保留未解析字符串：

application:
  osgi-directory-path: "/media/.../webapp/target/osgi"
  plugins-properties-location: "/media/.../webapp/src/main/conf/plugins-properties.yml"
  dataset-properties:
    persona-project-path: "${project.parent.basedir}/sample/dataset"

原因分析 #

这个现象的核心在于Maven属性解析的阶段差异和上下文限制：

1. 当前项目与父项目内置属性的解析时机不同

   • ${project.basedir}、${project.build.directory}属于当前项目的内置属性，Maven在加载当前项目模型的初期就会完成解析赋值，因此在自定义属性中引用这些值时，会直接被替换为实际路径，后续资源过滤就能拿到解析后的结果。
   • ${project.parent.basedir}是父项目的内置属性，它的解析依赖于父项目模型的完全加载。当单独在模块目录下执行mvn resource:resource时，Maven加载当前项目模型的阶段，父项目的basedir属性可能尚未完成初始化，或者当前项目的属性解析上下文未包含父项目的内置属性，导致${project.parent.basedir}无法被插值，保留为原始字符串。

2. 资源过滤的属性查找逻辑差异
   直接在application.yml中使用@project.parent.basedir@时，maven-resources-plugin会从全局Maven属性上下文（包含当前项目和已加载的父项目的所有属性）中查找对应值，此时父项目已完成加载，因此能正确解析。但如果先将${project.parent.basedir}写入当前项目的自定义属性，而这个自定义属性在pom解析阶段未完成插值，那么资源过滤时引用该自定义属性，得到的就是未解析的原始字符串。

临时解决方法的原理 #

你使用<project.persona-project-path>@project.parent.basedir@/sample/dataset</project.persona-project-path>的方式，本质是将父项目属性的解析延迟到了资源过滤阶段：此时Maven已经完全加载父项目模型，插件可以直接从全局属性上下文中获取project.parent.basedir的实际值并完成替换，最终得到正确的路径。

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