You need to enable JavaScript to run this app. Spring Boot将src/test下资源加载到classpath不生效问题求解
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot将src/test下资源加载到classpath不生效问题求解

问题原因
  1. 对WebMvcConfigurer.addResourceHandlers()的作用理解错误:该方法仅用于配置Web请求的静态资源访问路径映射,和JVM类路径加载逻辑完全无关,不会修改classpath对应的资源范围,你通过classpath*:前缀读取资源的逻辑不受该配置影响。
  2. 构建工具默认规则限制:Maven/Gradle的标准项目结构中,src/test/java、src/test/resources属于测试范围的目录,仅在执行单元测试时才会被加入类路径,正常启动主应用程序时,这两个目录的内容不会被编译、打包到运行时类路径中。
  3. 资源映射配置错配:你当前编写的资源映射规则中,addResourceLocations配置的路径全部指向classpath:/main/resources相关目录,和你要加载的test目录资源完全不匹配,就算是通过Web接口访问也找不到对应资源。
  4. 资源读取路径不匹配:你用classpath*:/com/读取资源时,test目录下的com包内容根本不在运行时类路径中,自然返回空结果。
解决方案

根据使用场景选择对应方案:

  • 开发调试阶段需要在主程序中访问test目录资源:
    修改构建工具配置,将test目录加入主程序的源码/资源目录:

    1. Maven项目在pom.xml的build节点添加如下配置:
    <build>
      <resources>
        <resource>
          <directory>src/main/resources</directory>
        </resource>
        <resource>
          <directory>src/test/resources</directory>
        </resource>
      </resources>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <configuration>
            <compileSourceRoots>
              <compileSourceRoot>src/main/java</compileSourceRoot>
              <compileSourceRoot>src/test/java</compileSourceRoot>
            </compileSourceRoots>
          </configuration>
        </plugin>
      </plugins>
    </build>
    
    1. Gradle项目在build.gradle中添加如下配置:
    sourceSets {
      main {
        resources.srcDir 'src/test/resources'
        java.srcDir 'src/test/java'
      }
    }
    

    配置完成后无需保留之前的addResourceHandlers相关代码,直接通过classpath*:前缀即可读取对应资源。

  • 仅单元测试运行时找不到资源:
    确认测试类添加了@SpringBootTest注解,单元测试运行时默认会自动把src/test/java、src/test/resources加入类路径,直接按资源相对路径读取即可,不需要额外配置。

  • 生产环境需要使用相关资源:
    直接将需要用到的资源、类从src/test目录移动到src/main对应的目录下即可,test目录本身仅用于存放测试相关代码,标准生产构建流程不会包含该目录的内容。

内容的提问来源于stack exchange,提问作者Itsik Mauyhas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 07:27:02