SpringBoot - 为什么部分RESOURCE未打包?

本文介绍了如何在SpringBoot项目中处理非默认资源目录的配置,包括使用<resources>标签和MAVEN-RESOURCES-PLUGIN插件,以及src/main/resources与src/test/resources的资源加载规则。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

写在前面

在SpringBoot的项目中,默认情况下资源文件放置放在src/main/resources 中,而单元测试的资源文件放在src/test/resources中。
如果部分资源文件未放在SpringBoot默认的目录下怎么办?

默认情况下源码存放资源的目录结构:

在这里插入图片描述

默认情况下打包后的文件目录为:

在这里插入图片描述

src/main/resources 与 src/test/resources 下的资源文件的使用与加载区别是什么?

A. src/main/java中的JAVA代码只能直接加载 src/main/resources 下的资源,不能直接加载 src/test/resources 下的资源;
B. src/test/java中的JAVA代码既能加载 src/test/resources 下的资源,又能加载 src/main/resources 下的资源,当两个 resources 下都有要加载的同名资源时候,优先选择 src/test/resources 下的资源。

解决方案

方案①: 使用<resources> 标签

重新指明资源文件位置 (所有需要被打包都需要指定,并不是只指定非默认目录下的资源)

<build>
   <finalName>${project.artifactId}</finalName>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
    <!-- 重新指明资源文件位置 (所有需要被打包都需要指定,并不是只指定非默认目录下的资源) -->
    <resources>
        <resource>
            <directory>src/test/resources</directory>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <!-- 其中 **/*.xml 这样的写法,是为了保证各级子目录下的资源文件被打包。 -->
                <include>**/*.xml</include>
            </includes>
        </resource>
    </resources>
</build>
方案②: 使用MAVEN-RESOURCES-PLUGIN插件

使用MAVEN-RESOURCES-PLUGIN, 将未在默认资源目录下的资源打进包中, 默认资源目录下的资源无需指定能够自动被打包。

<build>
   <finalName>${project.artifactId}</finalName>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

        <!-- 使用MAVEN-RESOURCES-PLUGIN, 将未在默认资源目录下的资源打进包中, 默认资源目录下的资源无需指定能够自动被打包-->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <executions>
                <execution>
                    <id>copy-other-resources</id>
                    <phase>process-resources</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${basedir}/target/classes</outputDirectory>
                        <resources>
                            <resource>
                                <directory>${basedir}/src/main/java</directory>
                                <includes>
                                    <include>**/*.xml</include>
                                </includes>
                            </resource>
                            <resource>
                                <directory>${basedir}/src/test/resources</directory>
                                <excludes>
                                    <exclude>banner.txt</exclude>
                                </excludes>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>
### 如何在 Spring Boot 中正确打包 resources 文件夹内的资源文件 为了确保 `resources` 目录下的文件能够被正确打包到最终的 JAR 文件中,可以采取以下措施: #### 修改 Maven 配置 如果遇到 `target` 目录下缺少 `resources` 目录的情况,可能是由于 Maven 的默认设置将这些文件包含进去。通过调整 `pom.xml` 文件来修正这个问题[^2]。 ```xml <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.*</include> </includes> </resource> </resources> </build> ``` 这段 XML 片段指定了要包含哪些类型的文件进入构建过程,并将其加入到输出的 JAR 文件里。 #### 使用 ClassPathResource 加载资源 当应用程序被打包成 JAR 后,可以直接利用 Spring Framework 提供的 `ClassPathResource` 类加载位于 classpath 下面的任何位置上的静态资源文件[^3]。 ```java String pdfFilePath = "template/test.pdf"; Resource resource = new ClassPathResource(pdfFilePath); InputStream inputStream = resource.getInputStream(); // 进一步处理输入流... ``` 这种方法适用于大多数场景,无论是开发阶段还是部署后的生产环境中都能稳定工作。 #### 确认打包工具配置无误 除了上述方法外,还需要确认使用的打包插件(如 spring-boot-maven-plugin 或者 gradle 插件)已经正确配置好,以便支持嵌入式的 Tomcat/Undertow 等服务器启动时自动识别并加载所需的资源配置项[^1]。 对于基于 Gradle 构建的应用程序,则应检查 build.gradle 文件中的相应部分是否有类似的设定。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

cloneme01

谢谢您的支持与鼓励!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值