Web Notes for Michael Wan

Just some notes in GitHub ...

Adding local jar into maven and SpringBoot jar

Post Date: 2025-05-22

To add a local jar file into maven project as the dependency, it almost same as other dependency in the pom file. The difference is just you have to declare the scope as system and provide the path of the jar file as below.

<dependency>
    <groupId>micwan88.github.com</groupId>
    <artifactId>local-lib</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${basedir}/somewhere/local-lib-1.0.0.jar</systemPath>
</dependency>

Please noted that by default SpringBoot won’t include this local jar when you build the SpringBoot executable jar.

To solve this problem, what you have to do is just adding one more setting for SpringBoot as below.

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <includeSystemScope>true</includeSystemScope>
            </configuration>
        </plugin>
    </plugins>
</build>

References: