背景
有时候项目里需要使用一些没有源码的三方jar包,通过在pom里添加systemPath来指明jar包的位置,在本地调试的时候一切ok,但是同样的代码通过mvn package发到线上运行就提示依赖的jar包找不到。
原因
当引用第三方包,且没有源代码时候,可以使用systemPath
<dependency>
<groupId>ctec</groupId>
<artifactId>xxx-core</artifactId>
<version>1.0</version>
<scope>system</scope>
<systemPath>${project.basedir}/src/main/resources/libs/xxxxxx.jar</systemPath>
</dependency>
划重点!!!敲黑板!!!下面的一步配置也是最重要的一步,缺少这一步,就会导致虽然本地可以运行,但是只要使用mvn打包就不行,因为scope为system的maven默认是不打包进去的。
需要使用true
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<includeSystemScope>true</includeSystemScope>
</configuration>
</plugin>
</plugins>
原理讲解
pom中的scope类型
dependency的scope有五种:
- compile:默认值 他表示被依赖项目需要参与当前项目的编译,还有后续的测试,运行周期也参与其中,是一个比较强的依赖。打包的时候通常需要包含进去
- test:依赖项目仅仅参与测试相关的工作,包括测试代码的编译和执行,不会被打包,例如junit
- runtime:表示被依赖项目无需参与项目的编译,不过后期的测试和运行周期需要其参与。与compile相比,跳过了编译而已。例如JDBC驱动,适用运行和测试阶段
- provided:打包的时候可以不用包进去,别的设施会提供。事实上该依赖理论上可以参与编译,测试,运行等周期。相当于compile,但是打包阶段做了exclude操作
- system:从参与度来说,和provided相同,不过被依赖项不会从maven仓库下载,而是从本地文件系统拿。需要添加systemPath的属性来定义路径
由此可见,scope为system的依赖,maven默认是不打包进去的,这也是导致线上提示jar缺失的原因。如果需要将scope为system的依赖也打包进来,需要添加true。
常见内置变量
- ${project.basedir} 项目根目录
- ${project.build.directory} 构建目录,缺省为target
- ${project.build.outputDirectory} 构建过程输出目录,缺省为target/classes
- ${project.build.finalName}产出物名称,缺省为${project.artifactId}-${project.version}
- ${project.packaging} 打包类型,缺省为jar
- ${project.xxx} 当前pom文件的任意节点的内容