前言

在日常开发中，绝大多数依赖都可以直接从 Maven 中央仓库获取，但有时还是会遇到一些特殊场景——比如公司内部的私有 jar、厂商提供的 JDBC 驱动，或是一些早已停止维护的第三方库。遇到这种情况，常见的做法是在工程目录下新建一个 lib 文件夹，把外部 jar 放进去，再手动添加到工程依赖中。

不过，这里面藏着一个坑：如果你使用 Maven 将项目打包成可执行的 Spring Boot 应用，这些 lib 目录下的 jar 默认并不会被自动包含进最终的 BOOT-INF/lib 目录。半年内，不少项目团队都因为这个踩过坑，所以今天咱们把这个完整流程梳理清楚。

一、添加外部 jar 包到 lib 目录

第一步非常简单：在工程根目录下创建 lib 文件夹，然后把所需的 jar 文件复制进去。

如果在本地开发时使用 IDE（例如 IntelliJ IDEA），可以右键 lib 目录，选择 Add as Library，这样本地编译和运行时就能正常引用到这些外部 jar 了。

但问题在于：本地能跑，一旦执行 mvn package 打包成 jar，你会发现这些外部 jar 并没有被自动打进去。你可以解压最终生成的 jar 文件，然后到 BOOT-INF/lib 目录下检查一下，确认到底缺少了什么。

二、配置 Maven 打包

1. pom.xml 配置

关键步骤来了：你需要在 pom.xml 的 中显式声明这些外部依赖，并且将 scope 设置为 system，同时通过 systemPath 指向 lib 目录下具体的 jar 文件。

仅仅声明还不够，下一步才是重点：在 标签内，通过 明确告知 Maven 在打包时，要把 lib 目录下的所有 jar 复制到 BOOT-INF/lib 下。

完整的 pom.xml 配置示例如下：

    
        
        
        
            com.cloudera
            ImpalaJDBC41
            41.0
            system
            ${project.basedir}/lib/ImpalaJDBC41.jar
        
        
        
            com.pivotal
            greenplum-jdbc
            5.1.4
            system
            ${project.basedir}/lib/greenplum-jdbc-5.1.4.jar
        
    
    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
            
                org.apache.maven.plugins
                maven-compiler-plugin
                3.1
                
                    ${java.version}
                    ${java.version}
                
            
        
        
            
                src/main/resources
            
            
                lib
                BOOT-INF/lib/
                
                    *.jar
                
            
        
    

配置完成后，执行 mvn package 打包，再去生成的 jar 中查看 BOOT-INF/lib 目录，你就会发现那些外部 jar 已经乖乖躺在里面了。

有一点需要特别留意：上面的 里，我们手动指定了 src/main/resources 的打包动作，这一步是必须的——如果不写，Maven 会默认将 resources 目录的内容打包进去，但一旦你自定义了 后，默认设置就会失效，所以需要显式补上，否则配置文件会被遗漏。

总结

一句话概括：将外部 jar 放在 lib 目录下，在 dependencies 里使用 system scope 进行声明，然后在 build/resources 里指定将 lib 目录复制到 BOOT-INF/lib。同时不要忘记把默认的 resources 目录也重新声明一遍。这套流程在实践中非常稳定，适用于各种 Spring Boot 项目对外部私有包的打包需求。