为什么Maven仓库配置段中${project.basedir}属性无法正常生效？

核心原因 #

Maven对POM的解析存在严格的阶段顺序，变量生效时机不同导致了差异：

• 读取<repositories>节点发生在POM解析的最早期：这个阶段需要先拉取父POM、依赖的BOM等元数据来完成POM的完整结构解析，项目内置属性${project.basedir}还没有完成初始化，因此不会被替换，直接被当作字符串拼接进仓库路径，你在错误日志里看到的file:/${project.basedir}/libs也印证了变量没有被解析。
• 插件配置读取发生在POM完全解析后：maven-dependency-plugin的配置是在POM结构完全解析、所有内置属性初始化完成后的构建执行阶段才会加载，所以${project.basedir}可以被正确替换为项目根目录的实际路径。

解决方案 #

你可以用以下任意一种方法修复：

• 直接使用相对路径配置仓库地址，Maven早期解析阶段支持相对于当前POM所在目录的相对路径：

  <repository>
    <id>example-repo</id>
    <name>Example Repository</name>
    <url>file:./libs</url>
  </repository>
  

• 如果需要全离线构建，也可以提前将所有依赖下载到Maven默认本地仓库，执行构建时添加-o参数启用离线模式，不需要额外配置项目内仓库。
• 也可以将本地仓库路径配置在settings.xml的自定义Profile中，通过系统属性传入路径，避免在POM的仓库配置段使用项目内置属性。

内容的提问来源于stack exchange，提问作者Ekaterina Ivanova iceja.net