Springboot 使用 maven-resources-plugin 打包变量替换jar没有打包进去、Jar包没有被使用

问题场景:

最近在使用环境分离,必须用到maven-resources-plugin来替换配置文件变量。遇到了一些问题。

  1. 程序写好了需要打包为packge.jar。
  2. 恰好本地使用了一些jar包(如:them.jar)作为依赖。
  3. jar包路径就在项目根目录的 lib 文件夹

问题1:本地依赖的jar包无法打包到程序包中

打完的包本地跑没有任何问题,发布到线上就找不到jar包报错:找不到 them.jar。为了找到问题测试了一下打包出 packge.jar 以后,将 lib 文件夹改为 lib1 运行 packge.jar 就报错找不到 them.jar ,看起来是没有打包进去。

问题1解决:

最终发现是没有打包进去,修改配置打包进去:

1、增加 project.repositories.dependency.scope 值为 system。

2、增加 project.build.plugins.plugin.configuration.includeSystemScope 值为 true。

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <repositories>
        <dependency>
            <groupId>org.apache.pdfbox</groupId>
            <artifactId>pdfbox</artifactId>
            <version>2.0.31</version>
            <!-- !!!注意这里,加上即可!!! -->
            <scope>system</scope>
            <!-- !!!注意这里,加上即可!!! -->
            <systemPath>${project.basedir}/lib/them.jar</systemPath>
        </dependency>
    </dependencies>
    <build>
        <finalName>${project.artifactId}-${project.version}-${spring.profiles.active}</finalName>
        <plugins>
            <!-- 外部 lib 导入到 jar 包中 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>1.4.2.RELEASE</version>
                <configuration>
                    <fork>true</fork>
                    <!-- !!!注意这里,加上即可!!! -->
                    <includeSystemScope>true</includeSystemScope>
                    <!-- !!!注意这里,加上即可!!! -->
                    <mainClass>com.test.TestApplication</mainClass>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

问题2:发现 packge.jar 解压 them.jar 在其中,但是还是不生效。

说明还是引用的项目根目录 /lib 里的 jar 包。

解决问题2:

配置问题,这里使用了 maven-resources-plugin ,就要使用其内部的 resource 不能使用 build.resource 标签了。

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <repositories>
        ...
    </dependencies>
    <build>
        <finalName>${project.artifactId}-${project.version}-${spring.profiles.active}</finalName>
        <!-- 替换变量用 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <executions>
                <execution>
                    <id>default-resources</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>target/classes</outputDirectory>
                        <useDefaultDelimiters>false</useDefaultDelimiters>
                        <delimiters>
                            <delimiter>@</delimiter>
                        </delimiters>
                        <!-- !!! 使用这里面的 resources !!! -->
                        <resources>
                            <resource>
                                <directory>src/main/java</directory>
                                <includes>
                                    <include>**/*.xml</include>
                                </includes>
                            </resource>
                            <resource>
                                <directory>src/main/webapp</directory>
                                <targetPath>META-INF/resources</targetPath>
                                <includes>
                                    <include>**/**</include>
                                </includes>
                            </resource>
                            <resource>
                                <directory>src/main/resources</directory>
                            </resource>
                            <resource>
                                <directory>src/main/resources</directory>
                                <filtering>true</filtering>
                            </resource>
                        </resources>
                        <!-- !!! 使用这里面的 resources !!! -->
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- !!! 外部 resources 弃用!!! -->
        <!-- <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
            </resource>
        </resources>-->
        <!-- !!! 外部 resources 弃用!!! -->
    </build>
</project>

问题3:发现插件maven-resources-plugin只在maven打包的时候生效

发现插件maven-resources-plugin只在maven打包的时候生效,只有使用maven命令生效,具体表现为:我们使用 idea 的 run 命令执行 maven-resources-plugin 下 resource 规则不生效资源没有进去,这就导致了使用 Rebel 热部署无法使用。

解决问题3:

使用 maven-resources-plugin只在maven打包的时候生,那就只能不用这个插件了。我的诉求就是只为了环境分离。

pom.xml改为:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    ...
    <properties>
        <java.version>8</java.version>
        <!-- !!!1、此处修改默认替换符!!!-->
        <resource.delimiter>${}</resource.delimiter>
    </properties>

    <dependencies>
        ...
    </dependencies>
    <profiles>
        <!-- !!!2、保留全部环境配置 !!!-->
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <spring.profiles.active>dev</spring.profiles.active>
            </properties>
        </profile>
        ... other profile
        </profile>
    </profiles>
    <build>
        <finalName>${project.artifactId}-${project.version}-${spring.profiles.active}</finalName>
        <plugins>
            <!-- 外部 lib 导入到 jar 包中 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>1.4.2.RELEASE</version>
                <configuration>
                    <fork>true</fork>
                    <includeSystemScope>true</includeSystemScope>
                    <mainClass>com.wpj.simple.SimpleApplication</mainClass>
                </configuration>
            </plugin>
            <!-- 打包结果输出用 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-antrun-plugin</artifactId>
                <executions>
                    <execution>
                        <id>print-custom-info</id>
                        <phase>package</phase>
                        <configuration>
                            <tasks>
                                <echo message="${spring.profiles.active} 环境打包执行成功"/>
                            </tasks>
                        </configuration>
                        <goals>
                            <goal>run</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/webapp</directory>
                <targetPath>META-INF/resources</targetPath>
                <includes>
                    <include>**/**</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/**</include>
                </includes>
                <excludes>
                    <exclude>jrebel.xml</exclude>
                </excludes>
            </resource>
            <!-- !!!4、环境替换再切换为 build.resources.resource !!!-->
            <resource>
                <directory>src/main/resources</directory>
                <!-- !!!5、开启替换 !!!-->
                <filtering>true</filtering>
                <includes>
                    <include>application.yml</include>
                </includes>
            </resource>
        </resources>
    </build>

</project>
  1. 复制代码
    1、project.properties.resource.delimiter 修改默认替换符。
    
    2、project.build.plugins.maven-resources-plugin 依赖删除。
    
    3、project.build.plugins.maven-resources-plugin.resources 移动到                project.build.plugins 下。

application.yml 改为:

spring:
  profiles:
    active: ${spring.profiles.active}

这样,project.profiles.profile.properties.spring.profiles.active 会替换成功,且热部署也可用、外部依赖依旧可以靠 spring-boot-maven-plugin 插件导入 jar 包中使用。

相关推荐
FIN技术铺8 分钟前
Spring Boot框架Starter组件整理
java·spring boot·后端
小码的头发丝、34 分钟前
Spring Boot 注解
java·spring boot
午觉千万别睡过37 分钟前
RuoYI分页不准确问题解决
spring boot
2301_811274311 小时前
大数据基于Spring Boot的化妆品推荐系统的设计与实现
大数据·spring boot·后端
Allen Bright2 小时前
maven概述
java·maven
编程重生之路2 小时前
Springboot启动异常 错误: 找不到或无法加载主类 xxx.Application异常
java·spring boot·后端
politeboy2 小时前
k8s启动springboot容器的时候,显示找不到application.yml文件
java·spring boot·kubernetes
世间万物皆对象8 小时前
Spring Boot核心概念:日志管理
java·spring boot·单元测试
qq_174482857510 小时前
springboot基于微信小程序的旧衣回收系统的设计与实现
spring boot·后端·微信小程序
代码小鑫12 小时前
A043-基于Spring Boot的秒杀系统设计与实现
java·开发语言·数据库·spring boot·后端·spring·毕业设计