如何从属性文件中获取Maven依赖的systemPath？

嘿，作为Maven新手，用system scope管理本地依赖确实是个常见的过渡方式，我来帮你搞定从属性文件读取systemPath的问题，步骤很清晰：

1. 创建外部属性文件 #

首先在你的项目根目录（或者src/main/resources目录，看你偏好）创建一个属性文件，比如命名为dependency-paths.properties，把每个依赖的本地路径以键值对的形式写进去：

# 示例：替换成你自己的依赖路径
dep.commons.codec=/Users/yourname/local-libs/commons-codec-1.15.jar
dep.commons.io=/Users/yourname/local-libs/commons-io-2.11.0.jar
dep.custom.utils=/Users/yourname/local-libs/custom-utils-2.0.jar

2. 在pom.xml中加载属性文件 #

我们需要用properties-maven-plugin来加载这个外部属性文件，让Maven能识别里面的变量。在pom的<build> -> <plugins>里添加这个插件配置：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>properties-maven-plugin</artifactId>
    <version>1.0.0</version>
    <executions>
        <execution>
            <!-- 在项目初始化阶段加载属性 -->
            <phase>initialize</phase>
            <goals>
                <goal>read-project-properties</goal>
            </goals>
            <configuration>
                <files>
                    <!-- 指定属性文件的路径，${project.basedir}是项目根目录的Maven内置变量 -->
                    <file>${project.basedir}/dependency-paths.properties</file>
                </files>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 在依赖中引用属性变量 #

现在你可以把原来硬编码的systemPath替换成属性文件里的变量了，比如：

<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>1.15</version>
    <scope>system</scope>
    <systemPath>${dep.commons.codec}</systemPath>
</dependency>

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.11.0</version>
    <scope>system</scope>
    <systemPath>${dep.commons.io}</systemPath>
</dependency>

重要提醒（必看） #

虽然上面的方法能解决你的问题，但我还是得说：system scope其实是Maven不推荐的用法，因为它会让你的项目依赖本地文件，换个环境构建就会失败。更规范的做法是把这些本地依赖安装到你的本地Maven仓库，命令如下：

mvn install:install-file -Dfile=/path/to/your.jar -DgroupId=com.your.group -DartifactId=your-artifact-id -Dversion=1.0.0 -Dpackaging=jar

安装完成后，你就能像普通Maven依赖一样引用，完全不需要system scope和systemPath了：

<dependency>
    <groupId>com.your.group</groupId>
    <artifactId>your-artifact-id</artifactId>
    <version>1.0.0</version>
</dependency>

如果因为某些原因必须用system scope，记得在打包时配置maven-dependency-plugin把这些本地依赖复制到输出目录，不然运行时会找不到jar包哦。

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