Maven 打包專案時包含本地 JAR：system scope 與 maven-install-plugin 兩大方案

專案依賴中央倉庫沒有的第三方 JAR（如廠商私有 SDK、舊版專屬驅動），Maven 打包時預設不會包含。本文介紹兩種標準解法：system scope（舊專案相容）與 maven-install-plugin 安裝至本地倉庫（現代推薦），並說明打包插件設定細節。

方案一：system Scope（不推薦新專案）

<dependency>
    <groupId>com.example</groupId>
    <artifactId>legacy-lib</artifactId>
    <version>1.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/legacy-lib-1.0.jar</systemPath>
</dependency>

缺點：

• 不會傳遞給依賴此專案的下游模組（傳遞性中斷）。
• 路徑硬編碼，跨機器建構易失敗。
• Maven 3.9+ 已棄用警告。

方案二：maven-install-plugin 安裝至本地倉庫（推薦）

1. 專案內綁定 install 階段自動安裝

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-install-plugin</artifactId>
            <version>3.1.2</version>
            <executions>
                <execution>
                    <id>install-external-jars</id>
                    <phase>initialize</phase>
                    <goals><goal>install-file</goal></goals>
                    <configuration>
                        <file>${project.basedir}/lib/legacy-lib-1.0.jar</file>
                        <groupId>com.example</groupId>
                        <artifactId>legacy-lib</artifactId>
                        <version>1.0</version>
                        <packaging>jar</packaging>
                        <generatePom>true</generatePom>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

執行 mvn clean install 即會自動安裝，後續依賴可用普通 compile scope 引用。

2. 手動安裝指令（一次性）

mvn install:install-file \
    -Dfile=lib/legacy-lib-1.0.jar \
    -DgroupId=com.example \
    -DartifactId=legacy-lib \
    -Dversion=1.0 \
    -Dpackaging=jar \
    -DgeneratePom=true

打包插件確保 JAR 進入最終產物

若為 Spring Boot Fat Jar：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <includeSystemScope>true</includeSystemScope>  <!-- 僅 system scope 需要 -->
    </configuration>
</plugin>

若為普通 maven-shade-plugin 或 maven-assembly-plugin：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <configuration>
        <createDependencyReducedPom>false</createDependencyReducedPom>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals><goal>shade</goal></goals>
        </execution>
    </executions>
</plugin>

安裝至本地倉庫後，systemPath 依賴會被視為普通依賴正確打包。

進階：建立私有 Nexus/Artifactory 代理本地 JAR

• 團隊專案請部署至私有倉庫，mvn deploy:deploy-file 上傳。
• 所有成員共享，避免各自手動 install、版本不一致。
• CI/CD 流程自動發布，版本管理完整。

常見問題

1. 上一篇文章： Oracle PL/SQL 字串分割函數：依分隔符切割並逐行處理
2. 下一篇文章： JSP 指令總結：page、include、taglib 完整屬性表與用法對比

Java 相關知識

Eclipse JFace 數據綁定深度解析（二）：核心 API 與實戰綁定機制

前言：為何需要數據綁定？ 在桌面應用開發中，領域對象與 UI

Eclipse 插件開發極速入門：從架構理解到圖形化編輯器實戰

Eclipse 不只是 IDE，更是一個由微小核心 + 海量

Eclipse TPTP 完整指南：安裝、配置與 Java 應用程式效能分析實戰

前言 在軟體開發生命週期中，編寫代碼只是第一步。為了交付高品

JSF 2 實戰：結合 CDI 打造 Ajax 化線上測驗向導

Java EE 6 引入的 JSF 2 與 CDI (Con